i-effect 2.7 installation of an update without graphical installer

Preparation

The preparations described below must be carried out before installing an update. They include backing up the existing system, checking the system requirements, and downloading and making available the installation objects.

Backup i-effect

Backup the currently installed i-effect version as described in the manual at https://manual.i-effect.com/de/installation/vor-der-installation/upgrade-und-update/i-effect-sichern.

Recommendation

As an additional precaution, it is recommended to back up the contents of the i-effect libraries as well as the i-effect IFS directory (tape or SAVF). In a standard installation of i-effect these are the libraries IEFFECT, IEFFECTSYS and the IFS directory /i-effect/V2R7M0.

Check system requirements

The list of all necessary system requirements can be found on the i-effect website.

https://www.i-effect.com/de/systemvoraussetzungen

Use the system check tool available there or check manually in the list available there whether all necessary license programs and PTFs are available.

Proceed with the installation only if all system requirements are met.

Download i-effect

The current version can be downloaded here:

https://fileshare.menten.com/?hash=430a137f135fc4d24b3ab3ba007cc8db

Creating temporary objects

Temporary directories and libraries are required during installation. Create them with the following commands

Creating Temporary Objects

CODE

MD DIR('/tmp/iefftemp')
CRTLIB LIB(IEFFTEMP) TEXT('Temporary i-effect library (Installation)') 
CRTSAVF FILE(IEFFTEMP/IEFFECT) TEXT('Temporary i-effect installation savefile')

Transferring the installation Objects

From the downloaded ISO image on your PC, copy the contents of the /software folder to the newly created /tmp/iefftemp directory on IBM Power Systems.

Objects to be transferred

IEFFBASE.zip          STMF
IEFFECT.SAVF          STMF
IEFFOPT02.zip         STMF
IEFFOPT10.zip         STMF
IEFFOPT11.zip         STMF
IEFFOPT12.zip         STMF
IEFFOPT20.zip         STMF
IEFFOPT21.zip         STMF
IEFFOPT22.zip         STMF
IEFFOPT30.zip         STMF
IEFFOPT31.zip         STMF
IEFFOPT41.zip         STMF
IEFFOPT42.zip         STMF
IEFFOPT43.zip         STMF
IEFFOPT44.zip         STMF
IEFFOPT46.zip         STMF
IEFFOPT47.zip         STMF
IEFFOPT48.zip         STMF
IEFFOPT50.zip         STMF
IEFFOPT51.zip         STMF
IEFFOPT70.zip         STMF
IEFFOPT71.zip         STMF
IEFFOPT72.zip         STMF
IEFFOPT73.zip         STMF
IEFFOPT79.zip         STMF
IEFFOPT80.zip         STMF
IEFFOPT81.zip         STMF
IEFFOPT82.zip         STMF
IEFFOPT83.zip         STMF
IEFFOPT84.zip         STMF
IEFFOPT85.zip         STMF
IEFFOPT86.zip         STMF
IEFFOPT88.zip         STMF
IEFFOPT89.zip         STMF
IEFFOPT90.zip         STMF
IEFFOPT95.zip         STMF
IEFFOPT99.zip         STMF

Check and remove locks of i-effect objects

Make sure that no users work with i-effect during the installation and that there are no locks on the libraries or the user profile

CODE

WRKOBJLCK OBJ(IEFFECT) OBJTYPE(*LIB)  
WRKOBJLCK OBJ(IEFFECTSYS) OBJTYPE(*LIB)  
WRKOBJLCK OBJ(IEFFECT) OBJTYPE(*USRPRF)

Installation

It is recommended to use the graphical installer available with the product for installation. This automated installer performs many tasks from checking system requirements to backup and restore during the update/upgrade process. The use of alternative methods, such as the manual installation described here, is at your own risk. Also make sure that no i-effect objects are used during the installation, otherwise the installation will end abnormally.

Logging in to IBM Power Systems

Log on to your IBM Power Systems as the main security officer (QSECOFR)

Change the following settings for your job. The job must have the correct country CCSID of your environment and an overflowing message queue of the job must be prevented

Setting the job CCSID

CODE

CHGJOB JOBMSGQFL(*PRTWRAP) CCSID(37)  <-- For example, for primary language English

Monitor QSYSOPR

During installation, messages may appear in the system operator message queue. The following command can be used to make them immediately visible during the installation. Otherwise the QSYSOPR queue must be monitored, for example in a second job.

Monitor QSYSOPR

CODE

CHGMSGQ MSGQ(QSYSOPR) DLVRY(*BREAK)

Restoring the installation program

Enter the following commands to save the installation program back to the temporary library QTEMP.

Restoring the installation program

CODE

CPYFRMSTMF FROMSTMF('/tmp/iefftemp/ieffect.savf') TOMBR('/qsys.lib/iefftemp.lib/ieffect.file') MBROPT(*REPLACE)

RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(IEFFTEMP/IEFFECT)

Removing QTEMP from the system library list

Enter the following command to remove QTEMP from the system library list

Remove QTEMP from SYSLIBL

CODE

CHGSYSLIBL LIB(QTEMP) OPTION(*REMOVE)

The message Library QTEMP not in system part of the library list. can be ignored.

Enter the following command to add QTEMP to the user part of the library list

Add QTEMP to USRLIBL

CODE

ADDLIBLE LIB(QTEMP) POSITION(*FIRST)

The message Library QTEMP already exists in library list. can be ignored.

Customize user profile i-effect

The i-effect user profile must not have a memory limitation. Adjust the profile with the following command

Remove memory limitation of i-effect

CODE

CHGUSRPRF USRPRF(IEFFECT) MAXSTG(*NOMAX)

Do not assign an IASP

No IASP may be assigned during installation. Enter the following command to assign the system ASP

Assign system to ASP

CODE

SETASPGRP ASPGRP(*NONE)

Starting the installation

Start the installation program by entering the following command

CODE

QTEMP/SETUP

In the display shown, enter the following parameters to update the existing i-effect installation

CODE

                         i-effect Installation (INSTALL)  
                                                                                                       
Type choices, press Enter.
                                                                                                                                      
Primary system language  . . . . > 2924          Character value                
Primary language for i-effect  . > 2924          Character value, *NONE         
Type of installation . . . . . . > *UPDATE       *NEW, *UPDATE, *DOWNLOAD       
Already installed versions . . . > V2R6M0        Character value, *NONE         
Installed add. languages:                                                        
Language-ID  . . . . . . . . .   *NONE           *NONE, 2929, 2924, 2938...       
Library  . . . . . . . . . . .                   Character value                               + for more values                                                
Version to install . . . . . . . > V2R7M0        Character value                
Version to update  . . . . . . . > V2R6M0        Character value, *FIRST        
Additional languages:                                                             
Language-ID  . . . . . . . . . > *NONE           *NONE, 2929, 2924, 2938...       
Library  . . . . . . . . . . .                   Character value                               + for more values                                                
Target directory for WebContro   > '/www/zendsvr6/htdocs'                                                             
Installation mode  . . . . . . . > *ALL          *ALL, *SELECT

Accept Software Agreement

The software agreements are displayed during installation.

To accept the license terms and continue the installation, press F14

Message after acceptance of the license condition

CODE

Software agreement accepted. Installation of the license program will continue.

Reply to messages at QSYSOPR

In the course of the installation the following message can appear at the QSYSOPR, which must be answered with selection ( I )

CODE

(I C). Receiver QSQJRN2001 in IEFFECT was never saved completely.

Completing the installation

The installation program send the following message at the end of a successful installation

CODE

 Message ID . . . . . . :   GZI1002       Severity . . . . . . . :   00          
Message type . . . . . :   Information                                          
Date sent  . . . . . . :   05/25/20      Time sent  . . . . . . :   16:22:26 
                                                                                   
Message . . . . :   The installation/configuration was finished succesfully.    
The installation of the i-effect program was finished successfully.

Checking the installation

The following command can be used to check whether i-effect has been installed completely and without errors

CHKPRDOPT PRDID(2MEBEFF)
          RLS(V2R7M0)
          OPTION(*ALL)
          LODID(*ALL)
          CHKSIG(*NONE)
          DETAIL(*BASIC)

In case the installation was successfully, CHKPRDOPT sends this message. In case of an error the JOBLOG will indicate the cause of the errors.

CODE

Message ID . . . . . . :   CPC0C20       Severity . . . . . . . :   00      
Message type . . . . . :   Completion                                       
Date sent  . . . . . . :   05/25/20      Time sent  . . . . . . :   16:38:34                                                                            
Message . . . . :   No errors detected by CHKPRDOPT.                        
Cause . . . . . :   When you used the Check Product Option (CHKPRDOPT)        
   command, no errors were detected in the product loads that were checked.  
Recovery  . . . :   See the previously listed messages for details on each    
   product load that was checked.

Delete temporary objects

After successful installation, the following temporary objects can be deleted.

Deleting Temporary Objects

CODE

RMDIR DIR('/tmp/iefftemp') SUBTREE(*ALL) RMVLNK(*YES)         
DLTLIB LIB(IEFFTEMP)