QFRCOBJCVN system value can cause V14 SP1 LANSA for i upgrade failure

Date:13 January 2017
Product/Release:LANSA for i - V14 SP1
Abstract:Upgrade to V14 SP1 can fail due to FRCOBJCVN value
Submitted By:LANSA Technical Support

Description:

When upgrading to V14 SP1, a few customers have experienced an upgrade failure with the following messages in the joblog

CPF37A7 Escape 30 11/01/17 13:46:09.639393 QSRROCPR QSYS 064B DC@LOADERU LANSAINS01 *STMT
To module . . . . . . . . . : DC@LOADERU
To procedure . . . . . . . : DC@LOADERU
Statement . . . . . . . . . : 227500
Message . . . . : FRCOBJCVN value not allowed.
Cause . . . . . : The value you specified for FRCOBJCVN is not allowed with
the current value of the QFRCCVNRST system value. Recovery . . . : The
following combinations of FRCOBJCVN and QFRCCVNRST are allowed: -- If
FRCOBJCVN(*NO) is specified, then the QFRCCVNRST system value must have a
value of either 0 or 1. -- If FRCOBJCVN(*YES *RQD) is specified, then the
QFRCCVNRST system value must have a value of either 0, 1, or 2. -- If
FRCOBJCVN(*YES *ALL) is specified, then the QFRCCVNRST system value can have
any valid value and FRCOBJCVN(*YES *ALL) will override the system value.
CPF37A7 Information 30 11/01/17 13:46:09.640889 DC@LOADERU LANSAINS01 *STMT DC@LOAD25 LANSAINS01 *STMT
From module . . . . . . . . : DC@LOADERU
From procedure . . . . . . : DC@LOADERU
Statement . . . . . . . . . : 231600
Statement . . . . . . . . . : 5700
Message . . . . : INS0160 = Upgrade point of no return was passed. Do not
use the system. Do not attempt to upgrade again..
Cause . . . . . : This message is used by application programs as a general
escape message.

A change was included in V14 and V14 SP1 to have FRCOBJCVN(*YES) on all RSTOBJ (& RSTLIB) commands when importing on IBM i. However, a conflict can arise between the FRCOBJCVN(*YES) and the QFRCCVNRST system value, when it is set greater than 2.

Solution:

The solution is to:

  • End the upgrade
  • Restore your LANSA system from backup
  • Set the QFRCCVNRST system value to an allowed value ie. 0
  • Rerun the upgrade.

Notes:

  • You must restore from backup as per the message in the upgrade joblog INS0160 = Upgrade point of no return was passed. Do not use the system. Do not attempt to upgrade again.
  • This issue can affect both LANSA installs and LANSA upgrades.
  • The next version of the LANSA installation software will be enhanced to prevent this conflict affecting the install/upgrade.