LANSA iSeries upgrade or installation failure due to QSHELL or MAXJOB settings

Date:12 August 2005
Product/Release:LANSA for iSeries
Abstract:LANSA install/upgrade can fail if it uses a jobq/subsystem that does not allow QSHELL jobs to run or there is not enough MAXJOBs value for the subsystem
Submitted By:LANSA Technical Support

Description:

The following error may be generated while completing a LANSA iSeries install or upgrade.

Error found with QSH session, reason code 4, errno 3489.

Function check. QSH0002 unmonitored by LODEPC751N at statement 0000007600, instruction X'0000'.

QSH0002 received by procedure DC@LOAD250. (C D I R)

The error is caused by the fact that the install/upgrade uses a jobq/subsystem that does not allow QSHELL jobs to run or there is not enough MAXJOBs value for the subsystem. This situation is documented in the Troubleshooting section of the Installing LANSA on iSeries Guide.

Solution:

The generic solution is to use a jobq/subsystem that allows QSHELL jobs to run or to increase the MAXJOBs value in the subsystem that was originally used.

If this error occurs while applying an EPC to V11.0, ensure the following steps are completed:

  1. Backup all the LANSA libraries and the LANSA IFS
  2. Backup or Rename the LANSAECXXX library
  3. Delete the EPC work library LANSAINS02
  4. Remove or clear the EPC log file DC@FEP
  5. Use a jobq/subsystem that allows QSHELL jobs to run or increase the MAXJOBs value in the subsystem that was originally used