LANSA Composer Upgrade on IBM i may restore IFS content to the wrong location

Date:17 May 2016
Product/Release:LANSA Composer - V6.0
Abstract:When upgrading LANSA Composer on an IBM i server from version 5.0 to version 6.0, in some cases the IFS content may be restored to the wrong location.
Submitted By:LANSA Technical Support

Description:

When upgrading LANSA Composer on an IBM i server from version 5.0 to version 6.0, in some cases the IFS content may be restored to the wrong location. As a result, some new or revised content may not be properly further deployed to the correct run-time locations, rendering some LANSA Composer features inoperable. For example, the files necessary to support the new web-browser based Management console may not be properly deployed, rendering the Management Console inoperable.
This happens if the LANSA Composer system setting Default trading partner linked directory no longer corresponds exactly to the location of the root IFS directory for LANSA Composer content.

The root IFS directory containing the LANSA Composer files is often a location like this:
/LANSA_Composer_licpgmlib/LIC
Work with Object Links Screen
If the Default trading partner linked directory value is set to another location (as it frequently and legitimately is), then this issue will arise. For example, many customers set it to a location like this:
/LANSA_Composer_licpgmlib/LIC/TPS
Default trading partner linked directory
In this example, new or revised content that should have been restored to the first location is restored to the Default trading partner linked directory instead.
This will be corrected for future versions.
In the meantime, depending on whether you have already upgraded, you should follow one of the following procedures:

If you have not already upgraded, follow this procedure to avoid the issue.
Immediately before you begin the upgrade (and while no LANSA Composer processing sequences are active), do these steps:

  1. Determine the directory on your system that is the root IFS directory containing the LANSA Composer files – for example /LANSA_Composer_licpgmlib/LIC
    If you are unsure of the location, display the data area DCXLIDD01 in the LANSA Composer program library (for example, DSPDTAARA LICPGMLIB/DCXLIDD01). Take note of the path beginning in position 7 and add ‘/LIC’ to it.
  2. Start a LANSA Composer client, go to System Settings and check the value of the Default trading partner linked directory setting.
  3. If they are the same, you will not be affected by this issue and you can immediately disregard the rest of this procedure.
  4. If they are different, then (a) make a note of the current value, and (b) set the value of the Default trading partner linked directory setting to the value from step 1.
  5. Make sure you close the LANSA Composer client before proceeding with the upgrade.
    Now proceed with the upgrade. When the upgrade has completed, perform these steps:
  6. Install and start the LANSA Composer 6 client software, connect to the server and complete the LANSA Composer Server Initialization as usual.
  7. Start the LANSA Composer client, go to System Settings and restore the value of the Default trading partner linked directory setting to the value you noted in step 4.

If you have already upgraded, follow this procedure to diagnose and remedy the issue.
Follow these steps to determine whether your system is affected by this issue and to correct it if necessary:

  1. Determine the directory on your system that is the root IFS directory containing the LANSA Composer files – for example /LANSA_Composer_licpgmlib/LIC.
    If you are unsure of the location, display the data area DCXLIDD01 in the LANSA Composer program library (for example, DSPDTAARA LICPGMLIB/DCXLIDD01). Take note of the path beginning in position 7 and add ‘/LIC’ to it.
  2. Start a LANSA Composer client, go to System Settings and check the value of the Default trading partner linked directory setting.
  3. If they are the same, you have not been affected by this issue and you can immediately disregard the rest of this procedure.
  4. If they are different, then files and directories that should have been restored to the directory from step (1) have been restored to the Default trading partner linked directory instead. You should contact LANSA Support and request Hotfix 004 for LANSA Composer version 6.0. The hotfix contains software and instructions to correct your LANSA Composer installation.

Note: LANSA Composer on Windows servers is not affected by this issue.