RPG Toolbox Downloads

Pre-Installation Notes

The Toolbox software restores onto the IBM i as a Licensed Program named 4RPGBOX. After you restore this licensed program, the software will be contained in the library named RPGTOOLBOX.

Requirements

To install the Toolbox, the following requirements must be met:

• IBM i release 7.2 or greater installed on your IBM i.
• Your user id must have authority to the RSTLICPGM command.
• If you need to use the Toolbox feature which converts RPG III or RPG/400 source code to RPG IV, you must have IBM’s ILE RPG compiler installed on your IBM i (since IBM’s CVTRPGSRC command is used during the preliminary conversion process).

Installation

Important: Make sure you have read the “Pre-Installation Notes” listed on the prior page if upgrading from a prior version of RPG Toolbox.

The RPG Toolbox software is contained in an IBM i Save file, which needs to be uploaded to your system through FTP. Perform the following steps to install (or upgrade) the RPG Toolbox product onto the system.

1. Create a temporary Save file on your system by executing the following IBM i command: CRTSAVF FILE(QGPL/RPGBOXSF)

2. Before proceeding, make sure the FTP server is running on the system. To start the FTP server on the system, execute the IBM i command: STRTCPSVR SERVER(*FTP)

3. FTP the file RPGBOX.SAVF from your PC to the Save file created in step 1. Listed below are instructions for a Windows user:

• Open a DOS window.
• Enter the DOS command FTP , where is the host name or IP address of your IBM i.
• Login with your IBM i user id and password, then enter the following highlighted FTP commands on your PC: ftp> BINARY (switches the FTP session to binary mode) ftp> LCD \ ( is the PC directory containing the file RPGBOX.SAVF) ftp> CD qgpl (changes the remote directory to the QGPL library) ftp> PUT rpgbox.savf rpgboxsf (sends the PC file RPGBOX.SAVF to the IBM i file RPGBOXSF) ftp> QUIT (ends your FTP session)

4. Restore the licensed program from the Save file by running the IBM i command: RSTLICPGM LICPGM(4RPGBOX) DEV(*SAVF) SAVF(QGPL/RPGBOXSF)

5. Delete the temporary Save file by running the IBM i command: DLTF FILE(QGPL/RPGBOXSF)

6. Continue with the section labeled “Creating PDM Options”.

Updates

Considerations for Updates

You should not delete the existing Toolbox licensed program or library before upgrading, otherwise usercreated data (i.e. custom SEU line commands) will be lost.

The SNIPPETS source file in the RPGTOOLBOX library will be replaced during an upgrade. If you have created or modified any source members within that source file, please backup those source members before the upgrade. You should always refrain from modifying or creating source members directly in the RPGTOOLBOX/SNIPPETS source file.

Check for Locks

Before installation, make sure there are no locks on the file RPGTOOLBOX/BXP030. If this file is locked, then inform the user(s) with the locks to either:

1. Sign Off or
2. From within SEU, run the Toolbox line command of RESET.

Retention of User Data

If you already have a permanent license key to the Toolbox, the key will be retained during an upgrade.

The following user-defined data will be retained through the Toolbox upgrade:

• User-defined SEU line commands.
• User-defined Snippet Index Records.
• User-defined Snippet Source Types and Categories used for searching.
• Any defaults which were specified on the CHGDFT (Change RPG Wizard defaults) command.

During the installation process, a copy of the existing Toolbox data will be saved into a library called RPGTBxxxxx, where xxxxx is a sequential number starting with 00001. This library will only be needed if an upgrade fails, in which case you should contact Fortra.

Follow the instructions above to install the new version of RPG Toolbox.

Downloads

Documentation