Code migration tools

IBM® TPF Toolkit provides tools to help you convert your code to single source for the TPF 4.1 system and z/TPF system. The TPF Toolkit tools scan both assembler and C language source and identify problems that would prevent you from having single source code. When the code has been scanned, you can work with the results of the scan in several ways: applying automatic fixes, comparing files that have not been converted with files that have been converted, or manually editing files with the editors that are provided in the TPF Toolkit. Each of the changes that are associated with making your code single source is the result of a specific rule. See the TPF Toolkit online help for more information about single source rules.

Table 1 shows additional code migration tools that are available to you. Also, see Migrating your application programs for more information about when and how to use some of these tools.

Table 1. Code migration tools
Tool name Description Location of tool
cvtto64 A 64-bit assembler conversion aid that:
  • Converts register instructions for use in 64-bit mode
  • Converts 31- and 32-bit values to 64-bit register values
  • Converts most branch instructions to branch relatives
  • Converts applicable literal instructions to immediate instructions, where appropriate
  • Converts macro names as needed
  • Converts obsolete structured programming macro (SPM) names to the appropriate replacement macro name.

See the cvtto64.README file for more information about these tools and how to install and use them.

 TPF Family Products: Tools web page
maketpf.bsc.convert Converts TPF 4.1 build scripts to z/TPF makefiles.

Enter man maketpf.bsc.convert for information about how to use this tool.

 tpftools directory
convert_usrtpf2cntl Converts all entries in a usrtpf.cntl file into the control file format.

This script is a template; you must update this for your specific conventions. See the convert_usrtpf2cntl.README file for more information.

 base/util/migrationtools directory