Overview

Thank you for your interest in Dumpster, the free utility for dumping System i spooled file internals.

There are 3 steps to installing Dumpster on your System i. They are:

  1. Create a save file on your System i.
  2. Transfer the contents of file dmp.svf from your PC to the save file using FTP.
  3. Restoring Dumpster from the save file.

Procedures for each of these steps are detailed below. In these procedures PC denotes an operation performed on your PC while i5 denotes an operation performed on your System i. Enter represents the enter key.

But before you start, If you haven't already unzipped the download do so now by double clicking it, or by choosing Start > Run and specifying “dmp”.

Step 1. Save File Creation Procedure

To create a save file on your System i perform the following:

  1. i5 Sign on to your System i as the security officer (QSECOFR).
  2. i5 Create a save file by running the command:

    CRTSAVF FILE(QGPL/DMPSAVF) AUT(*ALL)

You are now ready to transfer dmp.svf to your System i.

Step 2. Transfer Procedure - FTP

To transfer dmp.svf to your System i using FTP, perform the following:

  1. i5 Insure the FTP server is active by running command:

    STRTCPSVR SERVER(*FTP)

  2. PC Choose Start > Programs > Accessories > Command Prompt. Change to the directory where you unzipped the downloaded file. This is usually:

    cd \Gumbo\ProdData\DMP\InstallEnter

  3. PC Open an FTP connection to the System i by running (substitute your system's name or IP address):

    FTP system_nameEnter

  4. PC Enter a user name and password when prompted.
  5. PC Change to binary (image) mode by running:

    binaryEnter

  6. PC Change to library/file/member mode by running:

    cd /qsys.lib/qgpl.libEnter
    quote site namefmt 0Enter

  7. PC Transfer the product save file by running:

    put dmp.svf qgpl/dmpsavfEnter

  8. PC End FTP and the command prompt by running:

    quitEnter
    exitEnter

You are now ready to restore Dumpster from the save file, go to Step 3 Restore Procedure.

Step 3. Restore Procedure

To restore Dumpster to your System i perform the following:

  1. i5 Verify that your System i is running i5/OS release V5R4M0 or a later release by running:

    DSPDTAARA DTAARA(QGPL/QSS1MRI)

    Note: If you are running a version of i5/OS earlier than V5R4M0, release V1R6M0 of Dumpster can not be installed on your System i. Download and install an earlier release.

  2. i5 Verify that user domain objects are allowed in the product's library DUMPSTER and in library QSRV by running:

    WRKSYSVAL SYSVAL(QALWUSRDMN)

    Take option 5 to display the value. If the value is not *ALL, use option 2 to add libraries DUMPSTER and QSRV to the list of libraries where user domain objects are allowed. QSRV is required to correctly process PTFs when they are loaded and applied.

  3. i5 Insure that i5/OS will be able to verify the signatures that we apply to our product's objects by installing our Signing Certificate and Root CA Certificate in the system's *SIGNATUREVERIFICATION certificate store using Digital Certificate Manager. Alternately, insure that signature verification will not prevent the restore operation by running:

    WRKSYSVAL SYSVAL(QVFYOBJRST)

    Take option 5 to display the value. If the value is 3 or higher, use option 2 to temporarily change the value to 1.

  4. i5 Restore the product by running (you may wish to submit this command to batch):

    RSTLICPGM LICPGM(2A55DMP) DEV(*SAVF) SAVF(QGPL/DMPSAVF) LNG(2924)

  5. i5 Type GO DUMPSTER/DUMPSTER to display the product's main menu.
  6. i5 Select option 1 to display the on-line manual which contains additional instructions.
  7. PC The software is free. You are however agreeing to be bound by our license.

Additional Information

  1. During the restore operation the system operator message queue may receive inquiry message CPA3DE4 "Directory not registered. (C G)". Unless you are using a directory naming convention similar to ours (that is the directory specified in the CPA3DE4's second level text is unrelated to our software), You can safely respond with a "G" to reestablish the relationship between the directory and the product. Typically the message will occur three times.
  2. For additional information see IBM's® SC41-5120 i5/OS and related software Install, upgrade, or delete i5/OS and related software.