Migration Tips

This page illustrates helpful information when migrating to xTools version 4.0 or later from an earlier release.

If you migrate to version 4.0 you have the option to store the new XTOOLS service program in the XTOOLS library or in your legacy TOOLKIT library. If you choose to restore to your old TOOLKIT library, no source code changes are necessary.

If you use the recommended XTOOLS library, you may need to make one source code change to your existing applications that take advantage of the old TOOLKIT service program.

This source code change is only necessary if you hardcoded/qualified the TOOLKIT library name to the binding directory named RPGLIB, TOOLKIT or CGILIB in your source code, as follows:

If you did not qualify the binding directory in your source code, then NOT CHANGE is necessary.

To correct your source code, either change the qualifier to the new XTOOLS library (as illustrated above) or simply remove the qualifier and make sure the XTOOLS library is on the library list when you compile the source code.

If you are keeping your old TOOLKIT library around and installing the next XTOOLS library, the XTOOLS library should appear on the library list before the old TOOLKIT library.