EPC - 762

Date : 20 December 2005

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

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.

CCS 123754 for iSeries requires the OAMs to be rebuilt. Please check the "User Action" item below.

Description

EPC762 delivers fixes for Visual LANSA, LANSA for iSeries and LANSA for the Web.

Instructions to install the EPC

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

Instructions provided for:

YesLANSA for iSeries
YesiSeries Web Server (multi-tier)
YesVisual LANSA

Detailed changes

EPC762 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. Make sure no one is using the LANSA system to be upgraded.
  2. End the Listener and Host Monitor for this LANSA system.
  3. End the Web server and run the LANSA for the Web cleanup program.
  4. For iSeries shared folders:
    • in Explorer, map to the shared folder drive
    • create a folder named EPC762
    • copy unzipped file EPC762 to folder EPC762
  5. 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 EPC762
    • 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 EPC762
    • to send the downloaded file to the iSeries : enter command put EPC762
    • to exit : enter command quit
  6. 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.
  7. 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@EC762 (on the backup media) into library QTEMP.

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

    LOADEPC762 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 (LANSAEC762) 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 EPC762 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:

    LOADE762MT 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 (LANSAMT762) 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 EPC762w.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.

© 2005 LANSA

Back to Top