TPF Toolkit 4.6 Fix Pack 17 includes several enhancements.
Eclipse and Java version changes
The platform that TPF Toolkit is based on has been upgraded from Eclipse Photon (4.8) to Eclipse 2022-03 (4.23).
Additionally, the Java™ SDK that TPF Toolkit uses is changed from IBM SDK, Java Technology Edition to IBM Semeru Runtime Open Edition 17. IBM Semeru Runtime Open Edition 17 is not provided in the IBM Fix Central website. You can download it from the IBM Semeru Runtimes Downloads web page.
Installation procedure for TPF Toolkit 4.6 Fix Pack 17
The installation procedure for this fix pack is different from previous fix packs. TPF Toolkit 4.6 Fix Pack 16 or earlier instances cannot be upgraded to TPF Toolkit 4.6 Fix Pack 17. You must install TPF Toolkit 4.6 Fix Pack 17 independently but you can use the same workspace you currently use for TPF Toolkit 4.6 Fix Pack 16 or earlier.
The following list provides some high level steps to setup TPF Toolkit 4.6 Fix Pack 17:
- Download and install IBM Semeru Runtime Open Edition 17
- Download TPF Toolkit 4.6 Fix Pack 17 from IBM Fix Central and add it to your internal host for deployment as usual.
- Install a new instance from the product archive file or Eclipse Installer. TPF Toolkit Fix Pack 17 must be launched using the IBM Semeru Runtime Open Edition 17 that you installed in the previous step.
- Create a backup of the workspace location used by your previous instance.
- Launch the new instance and enter the same workspace location used by the previous instance. The workspace will be migrated to TPF Toolkit 4.6 Fix Pack 17.
- If you have a custom plugin project, update the execution environment to Java-17 (overview tab in the plugin.xml) and save.
If you have questions, contact the TPF Toolkit team by opening a case through the IBM Support portal.
TPF Toolkit Services web application enhancements
- The runtime version of Java was changed to Java 11
- The process of searching for files on Linux on IBM Z that are needed for the z/TPF debugger and code coverage was improved to be faster with less heap space
- Logging was improved with additional diagnostic messages to help easier problem determination
Deleting and renaming a synchronized project
The behaviors for deleting and renaming a synchronized project are enhanced.
In TPF Toolkit, when you delete a project that is in sync with a remote system, you can select or clear the Delete project contents on disk (cannot be undone) checkbox in the Delete Resources window to control whether to delete the project resources in the local workspace and on the remote system.
When you rename a project that is in sync with a remote system, the working directory in the C/C++ build configurations for the project is updated if the project name was used to resolve the working directory on the remote system. Additionally, if local C/C++ index files exist in the workspace, the files are deleted and retrieved again by using the new project name, and the index is rebuilt.
To view a list of behaviors when you delete or rename a synchronized project, you can click Preview in the Delete Resources or Rename Resources window.
Secure z/TPF connections
With APAR PJ46830 applied to your z/TPF system, you can securely connect to the z/TPF system in the Remote Systems view by using an SSH type connection. To use an SSH type connection, a public key and a private key must be specified in the SSH2 preference page. To open the SSH2 preference page, click Window > Preferences > General > Network Connections > SSH2.
Support for asterisks in workstation IP addresses for debug sessions
When you are configuring the workstation IP address to be used in debug sessions, you can use asterisks in any octet. For example, you can specify 9.*.*.* in the Workstation Address field in the TPF Debug preference page or in a debug session creation wizard. By using asterisks, TPF Toolkit can choose the correct local workstation IP address to use during the registration of a debug session on the z/TPF system. If the Automatically update workstation IP address checkbox is selected in the TPF Debug preference page, TPF Toolkit can choose the correct local workstation IP address if your local workstation IP address changes during a debug session.
For more information about these new enhancements and other features in TPF Toolkit 4.6, see the following resources:
What's new in TPF Toolkit 4.6 Fix Pack 17
TPF Toolkit demo videos
z/TPF Blog entries