How To Guide

Upgrading to Password Self Help 3

Last Updated:
May 31, 2017

These instructions guide you through the process of upgrading to Password Self Help 3.002 on your IBM i.

Note: Please ensure that you do not have a library on your system called @MSSHOLD. This library may exist from a previous upgrade of Password Self Help. If it exists, you must rename or delete it before you upgrade the product.

Before You Upgrade

  • Please ensure that the system value QALWOBJRST has a value of *ALL i.e. CHGSYSVAL SYSVAL(QALWOBJRST) VALUE(‘*ALL’)
  • We recommend that you ensure that the system value QFRCCVNRST is set to two i.e. CHGSYSVAL SYSVAL(QFRCCVNRST) VALUE(‘2’). This ensures that any program conversion is performed when the objects are restored. If you do not change this system value, the system will convert these programs as and when they are used. This may lead to users experiencing longer response times.
  • The QSECOFR security profile will be used during the installation process so make sure that you have access to the QSECOFR security officer profile. Do not use any other profile to load the software.
  • Please ensure that your current Self Help system is properly backed up. The library to back up is @MSSH. Complete this backup first before proceeding further. The installation must be in dedicated mode. To ensure that you are in a dedicated mode, use the command WRKOBJLCK QSYS/ @MSSH *LIB. No one should be signed on to this library. 
  • The installation time may vary between 0.25 hours to 1 hour depending on the size and usage of Self Help.
  • Please clear all reports (if any) in the @MSSH/SHOUTQ output queue. The output queue should be empty. If the queue is not empty, the upgrade installation may terminate abnormally. 


Password Self Help requires that you enter a valid license key. Contact if you need to request a new license key.

System Requirements

Password Self Help requires the following:

  • IBM i (i5/OS, OS/400) version V7R1M0 or higher
  • 30 MB of disk space 
  • Current IBM-supported PTF level

Compatibility Requirement with DetectIT

If you are using DetectIT's User Profile Manager module, before you upgrade to version 3.001 of Password Self Help, you will need to be on a compatible version of DetectIT.

  • The minimum is DetectIT version 14.4.2, with the addition of the following PTFs:
    • R881090823 Reduce number of file opens and close for Pre-Filter
    • R881090826 Convert Remote Command Requests
  • If you are on DetectIT 14.4.3, you need the addition of the following PTF:
    • R881090826 Convert Remote Command Requests

DetectIT version 14.4.4 and higher is compatible without special PTFs.

Upgrade Procedure

Ensure the following servers are available and running prior to upgrading:

  • FTP Server
  • Remote Command Server 

On the IBM i:

  1. Sign on with QSECOFR

On the PC:

  1. Login to My Account on the HelpSystems website and download the "Password Self Help for IMB i" zip file (SHPSAVF)
  2. Unzip SHPSAVF and save to pc
  3. Open command window
  4. FTP <IBM i>
  5. Sign on with QSECOFR
  6. Change to binary mode using the BIN command
  8. Wait until the transfer has finished

On the IBM i:

  1. Sign on with QSECOFR
  2. LODRUN DEV(*savf)  SAVF(< Save_File_Library >/< Save_File > )
    • Where: < Save_File > is name of save file that contains Self Help shipping library SHPSAVF
    • And: < Save_File_Library > is name of library containing < Save_File >
    • Example: LODRUN DEV(*savf) SAVF(QGPL/SELFHELP)
  3. This will prompt the APYDTISHP command:
    • Enter a ‘Y’, if you wish to transfer data. The system will automatically transfer the data from the old version after the installation of the new release. Typically, this process will only take a few minutes to complete. If you enter a ‘N’, the system will overlay the data from Self Help and thereby delete all the users and the control records that you have previously set up. Please note that the base IBM i user profiles (ALERTSH and SELFHELP) will not be deleted by this process.
    • Submit to batch: Type ‘N’ to run interactively. Type ‘Y’ to run the command in batch. The system will automatically prompt the SBMJOB command.
    • Device: *SAVF
    • Save file library: SHPSAVF
    • Library: Type the library to contain the installation objects. It will be created if it does not exist. The default is APYSHP. For a batch job the value cannot be QTEMP.
  4. Once all necessary parameters have been input press Enter. Note: If you entered ‘Y’ at the "Submit to batch" prompt the SBMJOB prompt screen will appear. Input the appropriate values and press Enter. For further details of the SBMJOB parameters please refer to the appropriate IBM manual.
  5. The upgrade routine will submit a job in QBATCH to delete the old version of Self Help that will be renamed to @MSSHOLD. This job will be held. Once you are ready to delete the older version, then please back up the library before releasing the deletion job.


Related Products