© Copyright 2003 by Robert Cozzi, Jr.
To install the xTools onto your AS/400 or iSeries, you will need access to both a PC display and an AS/400 command entry display.
Before transfer the xTools save file to your AS/400 or iSeries create a save file on your AS/400 or iSeries system. Sign on to your AS/400 or iSeries and go to a command entry display or command line window.
On your AS/400 or iSeries run the following OS/400 CL command to create the save file.
CRTSAVF SAVF(QGPL/XTOOLS)If the FTP server is NOT running on your system start it by issuing the following CL command:
STRTCPSVR *FTP
On your PC (any PC platform should work) start FTP and connect to your AS/400 or iSeries.
FTP myhost.domain.com/* where myhost.domain.com is the name of your AS/400 or iSeries */
Enter your FTP user ID and Password when prompted (it will be the same as your AS/400 User ID and Password).
Then run the following two FTP commands:
quote site namefmt 1cd /qsys.lib/qgpl.lib
At this point the AS/400/iSeries is naming convention is established and the QGPL library is set changed to the current library.
Now you need to determine where the save file is located on your PC. A good place to store this type of file is in a directory named C:\QTEMP or C:\Temp or something similar since shorter directory names are easier to work with in FTP. If you haven't already done so, make sure the XTOOLS.savf file you downloaded and extracted from the XTOOLS.ZIP file is stored in a known directory on your PC.
Enter the following FTP command to switch to the directory containing the xTools save file. Be sure to use the directory where the .savf file is located on your PC.
lcd c:\temp
You are now ready to upload the save file. First, you need to tell FTP to transfer the file unmodified, that is as a binary file rather than a plain ASCII text file. If you skip this step the save file's data will be corrupted.
Enter the following FTP command:
BINARY
You are now ready to begin the transfer. Remember, the save file is over 8 megabytes and may take a few minutes upload.
Enter the following FTP command to send the save file to your AS/400/iSeries system.
PUT xTools.savf
This command will start the transfer. Depending on the FTP software you're using you may or may not see a status message indicating the progress.
PUT xTools.savf (Replace
After a successful FTP transfer, you should end your FTP session by closing the window.
Enter the following FTP command:
QUIT
On some PC platforms, the BYE command is used instead of QUIT. If the QUIT command fails, issue the BYE command as follows:
BYE
# # #
What to do on your AS/400 iSeries after the save file is FTP'd to the system.
On the IBM AS/400, iSeries or i5, enter the following CL command:
RSTLIB SAVLIB(XTOOLS) DEV(*SAVF) SAVF(QGPL/XTOOLS)
You may restore the library to another library name, but the RPGLIB and CGILIB service programs must be run from the library into which they are restored. If you use a library other than XTOOLS, you will need to change the binding directory entry in the XTOOLS binding directory to point to the new library name. It is shipped with an entry of XTOOLS/RPGLIB and XTOOLS/CGILIB.
At this point the RPG xTools for OS/400 is loaded onto your system.
To compile, be sure to include the XTOOLS library on your library list when compiling.
To begin using the RPG xTools you must install a software license key. A license key may be acquired from our Request License Key web page at: http://www.rpgxtools.com/lickey.html
In order to use this automatic license key generation website, you must have a paid software license and a current software maintenance contract (also referred to as "software subscription").
[ Return to Introduction page ]