H-Series Application Migration Guide (H06.07+, J06.03+)

Migration Overview
H-Series Application Migration Guide—429855-008
1-4
TNS/R Native Mode to TNS/E Native Mode
The H-series systems continue to support the Guardian TNS compilers and tools. You
can continue to compile, run, and debug TNS applications on an H-series system in a
familiar TNS environment.
Like G-series systems, H-series systems support both an interpreted mode and an
accelerated mode for executing TNS object files. H-series systems provides an
interpreter for emulating TNS object code and an accelerator for accelerating TNS
code. For details on migrating G-series TNS programs to H-series systems, see
Appendix B, Migrating TNS Applications to H-Series Systems.
TNS execution is not supported in the OSS environment on H-series systems. All OSS
TNS programs must be converted to TNS/E native mode to run on an H-series system.
For details on converting TNS programs to native mode, see the TNS/E Native
Application Conversion Guide.
TNS/R Native Mode to TNS/E Native Mode
If your applications are already running in TNS/R native mode, then migrating them to
TNS/E native mode on an H-series system is a simple matter, usually requiring only a
recompilation using a TNS/E native compiler. Due to architectural differences between
the RISC and Itanium processors, TNS/R native programs must be recompiled before
they can be executed on an H-series system. TNS/R native object code cannot be
executed on an H-series system, and no interpreter or accelerator is provided to
emulate RISC instructions on the H-series system.
Migrating a TNS/R native application to TNS/E native mode requires, in most cases, no
source code changes. The few exceptions are noted in subsequent sections of this
guide. In addition to the few required changes, you might want to incorporate some of
the new H-series features into your applications, but none are required. Additionally,
some features considered obsolete in the TNS/R native programming languages are
not supported in the TNS/E native version of the language. The major changes in the
TNS/E environment are new command and utility names and some new or changed
parameters and options.
Because of increased clock rate and other execution capabilities of the Itanium
architecture, you can expect a significant performance improvement in your
applications after migrating them to TNS/E native mode.
Converting TNS Programs to TNS/E Native Mode
You can convert your G-series TNS applications directly to TNS/E native mode.
Converting applications to TNS/E native mode provides a significant performance
improvement over TNS interpreted or accelerated mode, even greater than converting
to TNS/R native mode.
Converting a TNS program to run in native mode is not covered in this guide. To do this
conversion, you can follow the guidelines given in the TNS/E Native Application
Conversion Guide to convert the TNS program directly to TNS/E native mode.
Alternatively, you can do the conversion in two steps: