PSPUTIL Installation Instructions

This page gives installation instructions for our Iseries utilities library.

You may receive the PSPUTIL software in the following ways:
  • 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.
  • On an ISeries tape where the PSPUTIL library is saved using the SAVLIB command. We only consider this as a last resort. Tapes themselves are expensive as is mailing them around the world. Seeing that the PSPUTIL utilities are very inexpensive anyway, we strongly prefer distributing the software via email attachments.

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, the transfer 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.
  • 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 in a release at the end of December 2007. You need to locate any clones of PCMPDBRS you created and upgrade them e.g. RNMOBJ the old file, CRTDUPOBJ the new format file from the PSPUTIL library, then run CPYF *MAP *DROP. Contact us if you need further help with this conversion.
The SAVF contains SAVLIB LIB(PSPUTIL) with target OS/400 release of V5R1M0, 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:
  • 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,572,672 bytes.
  • The PSPUTIL.zip file is 2,656,619 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.