PSPUTIL Installation Instructions

This page gives installation instructions for our ISeries utilities library.

You may receive the PSPUTIL software in the following ways:
  • Direct download of PSPUTIL.zip - around 2.5MB - from a secure area of our Web site.
  • A single email attachment PSPUTIL.zip - around 2.5MB.
  • If a single email attachment of 2.5MB can not get through your firewall, a series of separate email attachments PSPUTIL.zip.001, PSPUTIL.zip.002......PSPUTIL.zip.007 each of which is around 400K in size. You concatenate these as described below to build a single PSPUTIL.zip file.

To install the software:

  • If you received separate email attachments (PSPUTIL.zip.001 through PSPUTIL.zip.007), detach these to your PC then open a Windows command prompt and enter the following command (all on one line):

    copy /B psputil.zip.001 + psputil.zip.002 + psputil.zip.003 + psputil.zip.004 + psputil.zip.005 + psputil.zip.006 + psputil.zip.007 psputil.zip

    You should see a message like:

    PSPUTIL.zip.001 PSPUTIL.zip.002 PSPUTIL.zip.003 PSPUTIL.zip.004 PSPUTIL.zip.005 PSPUTIL.zip.006 PSPUTIL.zip.007 1 file(s) copied.
  • Double-click on PSPUTIL.zip to open the file using WinZip or similar ZIP software. You will see that PSPUTIL.ZIP contains one file PSPUTIL.SAVF. Extract this file PSPUTIL.SAVF to your PC drive.
  • Transfer the SAVF up to your ISeries to end up with a SAVF called PSPUTIL (probably in QGPL library). If you use FTP to do this transfer, you need to pre-create an empty SAVF on the ISeries first then FTP into that. The FTP transfer also needs to be 'binary', not 'ascii'. If you do not want to use FTP, then you can transfer in a different way if your ISeries is mapped as a Windows network drive (please contact us if you need further help with this method).
  • On your ISeries, rename any current PSPUTIL library you may have e.g. to PSPUTIL2. This is so you can go back to your previous version of the utilities if you want to. If you delete the old PSPUTIL library, make sure you save the contents of the PSPLICKEY and PSPUSR data areas somewhere first.
  • On your ISeries, run RSTLIB SAVLIB(PSPUTIL) DEV(*SAVF) SAVF(QGPL/PSPUTIL)
  • Check the authority of the PSPUTIL library and the objects within it after the RSTLIB. Make sure that whoever is going to use it has enough authority.
  • If you are starting a 30-day trial of PSPUTIL: If we have not given you a license key for this (e.g. in an email), you can get one yourself here. You must get this trial license key, otherwise PSPUTIL silently refuses to work - apart from messages to *SYSOPR.
  • If you are already a live user of PSPUTIL: Copy the contents of the PSPLICKEY and PSPUSR data areas from your old copy of the PSPUTIL library into the new PSPUTIL library. If you ever forget/lose your license key, you can get it again yourself here.
  • In principle the utilities should always be in the PSPUTIL library only e.g. some/all of the contents should not be copied/moved into other libraries, particularly if those libraries end up on a different ISeries system. A reasonable number of copies of the PSPUTIL library on offline media as part of your regular backup cycles are assumed, but you are still limited to the number of copies you have licensed - including backup and disaster recovery machines.
  • If you had a previous version of PSPUTIL and used the PCMPDBF command, note that the format of the PCMPDBRS results file changed several times. You need to manually migrate any old copies of PCMPDBRS to their new record format. Contact us if you need further help with this conversion.
The SAVF contains SAVLIB LIB(PSPUTIL) with target OS/400 release of V5R2M0, so RSTLIB on that or any later release should work. If you encounter any problems using the PSPUTIL library objects, you can check the following sizes for the current version of PSPUTIL:
  • The SAVF on our source ISeries running V5R3 is 10,506,240 bytes.
  • The SAVF as transferred to our source PC via binary FTP is 10,555,776 bytes.
  • The PSPUTIL.zip file is 2,662,808 bytes.
.

IBM rebranded the AS/400 - some users called it AS400 - to ISeries several years ago. All 3 names - ISeries, AS/400, AS400 - refer to exactly the same system.