H-Series Application Migration Guide (H06.03+)
Migration Overview
H-Series Application Migration Guide—429855-006
1-6
Developing TNS/R Applications on a TNS/E System
For additional details on these topics, see Section 2, The TNS/E Native Development
Environment.
Developing TNS/R Applications on a TNS/E System
TNS/R development tools are supported on TNS/E systems. You can compile and link
TNS/R native programs on a TNS/E system, and you can debug TNS/R native
snapshot files on a TNS/E system. However, TNS/R native object files, which consist
of RISC instructions, cannot be executed on a TNS/E system. You must transfer the
object files to a TNS/R system for execution. For details and a list of TNS/R tools
supported, see Developing TNS/R Native Programs on H-Series Systems on
page 2-16..
Summary of Migration Tasks
Following are summaries of the tasks required to migrate applications to an H-series
system.
G-Series (TNS/R) Native Mode to H-Series (TNS/E) Native Mode
In most cases, this is a simple procedure.
1. Verify that your program does not perform any privileged operations. If it does,
consult the resources described in Section 10, Where to Go for Assistance.
2. Verify that your program does not rely on the internal architecture of the TNS/R
server (primarily privileged operations and instruction-set architecture-specific
items such as the number of general registers and the size of a register save
area). If it does, extensive rewriting might be required. For assistance with these
kinds of operations, consult the resources described in Section 10, Where to Go
for Assistance.
3. Determine if the following issues affect execution of your program and make any
necessary changes. See the appropriate page for more information.
•
Misaligned Data Causes Performance Loss on page 4-2
•
Adjusting For Increased DCT Limits on page 4-3
4. Resolve any source code variances. It most cases, no source changes are
needed. Certain changes are optional, and certain other changes are needed only
in rare cases. See the following sections for more information:
•
Section 5, Native C and C++ Migration Tasks for C and C+ changes
•
Section 6, Native COBOL Migration Tasks for COBOL changes
•
Section 7, pTAL Migration Tasks for pTAL changes
5. If your program uses a user library, the user library must be rebuilt as a dynamic-
link library (DLL) on an H-series system.
Note. You cannot develop TNS/E native programs on a TNS/R system.