Mod05 application migration

Application MigrationApplication Migration
Module 5

NonStop S-Series to Integrity NonStopNonStop S-Series to Integrity NonStop
Migration PathsMigration Paths
migration paths:
◦ S-series TNS Mode to Integrity NonStop TNS Mode
◦ TNS/R Native Mode to TNS/E Native Mode
5 - Application Migration 2
TNS Mode
Native Mode
TNS Mode
Native Mode
S-series System (TNS/R)
Integrity NonStop System
(TNS/E)

NonStop S-Series TNS Mode toNonStop S-Series TNS Mode to
Integrity NonStop TNS ModeIntegrity NonStop TNS Mode
◦ Any TNS Guardian program that runs on
an S-series platform should run on an Integrity
NonStop with no changes
◦ TNS Guardian object code
can be emulated by an interpreter
◦ TNS Guardian object code accelerated in TNS/R
system can be accelerated again in TNS/E system
 Object file can contain both accelerated versions
◦ TNS execution is not supported in the HP NonStop
Open System Services (OSS) environment

TNS/R Native Mode toTNS/R Native Mode to
TNS/E Native ModeTNS/E Native Mode
Migrating object code running in TNS/R
native mode to run inTNS/E native mode
usually requires only a recompilation using a
TNS/E native compiler, except:
◦ In a few cases, source code needs changes
 For example, conditional compilation:
 “ if <TNS/R> … else … “ (TNS meant)
◦ To incorporate some of the new H- or J-series
features into the application for performance
improvement and other benefits
◦ Some features considered obsolete in the TNS/R
native programming languages are not supported
in the TNS/E native version of the language

Preparing Programs for MigrationPreparing Programs for Migration
◦ Be sure the program runs successfully on the
G06.20 or later G-series ReleaseVersion Update (RVU)
◦ If the program runs on an earlier RVU, see the
following documents and upgrade:
 G06.xx Software Installation and Upgrade Guide
 G06.xx ReleaseVersion Update Compendium
 Interactive Upgrade Guide and Interactive Upgrade Guide
2

Maintaining Common Source CodeMaintaining Common Source Code
◦ Most TNS/R native programs will require no
changes to migrate them to an Integrity
NonStop system
◦ When maintaining a common source code for
TNS/R and TNS/E native compilers:
 Do not use any of the new H- or J-series features
 Avoid using those few features in the TNS/R
programs that are not supported
in the H- or J-series RVUs

Alignment of DataAlignment of Data
◦ Different compilers align data items differently:
 TNS compilers align data on even-byte boundaries
 TNS/R and TNS/E compilers align 4-byte data items on 4-byte
boundaries
 TNS/E compilers also align 8-byte data items on 8-byte
boundaries
 TNS/E native POOL_GETSPACE_, GETPOOL, and malloc
procedures allocate buffers aligned on 16-byte boundaries
◦ Programming errors or run-time events can cause a
data item to violate the data alignment rules and can
change the behavior of the program.
◦ use EPTRACE
◦ Applications bound into GDSX must be recompiled.
◦ Because of 16-byte alignment in DEFINEPOOL

Adjusting for Increased DCT LimitsAdjusting for Increased DCT Limits
◦ The maximum size of the Destination Control Table
(DCT) can be optionally increased from 32,767 to
65,376 as of G06.23 RVU and H-series
 The default setting for the extended DCT limit is:
 OFF for G06.23 or later RVU
 OFF for H-series RVU (originally proposed to be on)
◦ The affected programs are those that call the
following
C-series procedures:
 FILEINFO
 GETDEVNAME
 GETPPDENTRY
 GETSYSTEMNAME
 LOCATESYSTEM
 LOOKUPPROCESSNAME

Adjusting for Increased DCT LimitsAdjusting for Increased DCT Limits
C-Series Procedure Replacement Procedure
FILEINFO FILE_GETINFOLIST_
GETDEVNAME DEVICE_GETINFOBYLDEV_, CONFIG_GETINFOBYLDEV_,
CONFIG_GETINFOBYLDEV2_, FILENAME_FINDSTART_,
FILENAME_FINDNEXT_
GETPPDENTRY PROCESS_GETPAIRINFO_
GETSYSTEMNAME NODENUMBER_TO_NODENAME_
LOCATESYSTEM NODENAME_TO_NODENUMBER_
LOOKUPPROCESSNAME PROCESS_GETPAIRINFO_
To migrate the affected programs:
◦ Change programs to use replacement procedures
◦ Use SCF to reset the DCT limits extension to ON

TNS/E pTAL CompilerTNS/E pTAL Compiler
◦ All TNS/R pTAL programs must be
recompiled with the TNS/E pTAL compiler.
◦ Most of the features and constructs of TNS/R
pTAL are supported in TNS/E pTAL, except:
 Some privileged operations
 Some features, such as SRL, that are not supported
in H-series RVUs
 Features considered obsolete in TNS/E pTAL
◦ All code produced by the TNS/E compilers is
position-independent code (PIC), which can
be used to create DLLs.

pTAL Compiler DirectivespTAL Compiler Directives
◦ Compiler directives that must be removed or
changed:
 SAVEGLOBALS: not supported
 USEGLOBALS: not supported
 NOCALL_SHARED: the compiler generates PIC only
 NOGP_OK: not needed; SRLs are not supported
 TARGET:TNS_R_TARGET option is not accepted.
Replaced by TNS_E_TARGET
◦ Compiler directives that are obsolete and are
ignored by the compiler (a warning is issued):
 BEGINCOMPILATION: not supported and is ignored
 SRL: not supported and warning is issued
 GP_OK, PUSHGP_OK, POPGP_OK, and NOGP_OK:
these SRL-related directives are ignored by the compiler

pTAL Compiler DirectivespTAL Compiler Directives
◦ Compiler directives that have different
behavior and may require source code
changes:
 OPTIMIZEFILE: warnings are issued in certain
conditions
 OVERFLOW_TRAPS and NOOVERFLOW_TRAPS:
In TNS/R pTAL, OVERFLOW_TRAPS is the default,
but in TNS/E pTAL, NOOVERFLOW_TRAPS is the
default

pTAL Functions and ProcedurespTAL Functions and Procedures
◦ Functions and procedures that are not supported
and should be replaced with H- or J-series
directly-called privileged interface:
 $EXECUTIO, $INTERROGATEIO,
$INTERROGATEHIO, $LOCATESPTHDR,
$LOCKPAGE, $READBASELIMIT, $READSPT,
$UNLOCKPAGE, and $WRITEPTE
◦ Functions and procedures that are changed:
 $AXADR: Replace with standard interface
 $FREEZE: Replace with the $TRIGGER function.
 $HALT: Replace with the $TRIGGER function.
 $STACK_ALLOCATE: Perform different rounding and alignment.
 Address of allocated area aligned to 16-byte boundary
 Size of allocated area rounded up to the multiple of 16 bytes

Other pTAL Migration TasksOther pTAL Migration Tasks
◦ Procedure attributes
 TNS/E pTAL does not support the INTERRUPT
procedure attribute
◦ 16-byte-aligned data
 The TNS/E pTAL compiler provides
STRUCTALIGN (MAXALIGN) attribute.This
attribute causes data to be aligned on the maximum
alignment defined for the platform, which is 16
bytes for TNS/E platform.

Other pTAL Migration TasksOther pTAL Migration Tasks
◦ FIELDALIGN directive in mixed language
programming
 FIELDALIGN (PLATFORM) causes the pTAL compiler to use
the same data alignment as other compilers on the same
platform
 FIELDALIGN (AUTO) allows the pTAL compiler to determine
data alignment based on what is most efficient
◦ Functions that return condition code and value:
 TNS/E pTAL compiler issues warning
 Not callable from C/C++
 TNS/R pTAL 64-bit workaround no longer works
 Write jacket procedure in pTAL

TNS/E Native C/C++ CompilersTNS/E Native C/C++ Compilers
◦ TNS/R and TNS/E native C/C++ compilers
conform to the ISO/ANSI C language
standard
 Programs migrating from TNS/R most likely require
no changes unless they depend on the underlying
machine architecture or use undocumented
features (mainly privileged features)
◦ C/C++ main routine object file name
 In Guardian: CCPLMAIN
 In OSS: cpplmain.o

Standard C++ Run-Time LibrariesStandard C++ Run-Time Libraries
◦ Three versions of the standard C++ library are
available on NonStop systems:
 VERSION1
 Data structures and algorithm libraries
 string, complex, and numeric_limits classes
 Not supported on Integrity NonStop systems
 Tools.h++ version 6.1 library
 VERSION2
 STL (Standard Template Library)
 Memory management, language support, locale and exception handling
features
 Tools.h++ version 7 library
 VERSION3
 Conforms to ISO/IEC IS 14882:1998 (E) standard for C++
 Does not support any version ofTools.h++ library

Native C/C++ Library MigrationNative C/C++ Library Migration
◦ Native C run-time library
 Native C run-time library on S-series and on Integrity
NonStop are nearly identical
◦ Native C++ run-time library
 Migrating from C++VERSION2 andVERSION3 on S-series
to the respective version on Integrity NonStop should
require no additional source code changes
 Migrating from C++VERSION1 on G-series to C++
VERSION2 on Integrity NonStop requires source code
changes
 If linking the program as a separate step, you must also specify the
ZCPPCDLL and ZCPP2DLL on the eld command
 Tools.h++ version 6.1, if any, should be migrated toTools.h++ version 7
 Recommendation is to migrate toVERSION3

Native C/C++ Library MigrationNative C/C++ Library Migration
◦ Native C++ run-time library (Continued)
 Migrating from C++VERSION1 on S-series to C++
changes
 The two versions are source code compatible; the only differences are
in the names of header files
 Requires source code changes to remove any use ofTools.h++ library
 Migrating from C++VERSION2 on S-series to C++
changes
 It is recommended that you convert to C++VERSION3 on
S-series, then to C++VERSION3 on Integrity NonStop
 Requires source code changes to remove any use ofTools.h++ library

Changed Pragmas and FlagsChanged Pragmas and Flags
◦ The following pragmas and flags are either obsolete
or have different behavior:
 EXTERN_DATA GP_OK allows GP-relative addressing for
external data references.This pragma is ignored and a
warning is issued in TNS/E systems.
 NON_SHARED pragma is ignored and a warning is issued
 SRL pragmas or –Wsrl flag is ignored and a warning is issued
 SRLExports or –Wsrlexports is ignored and a warning is
issued
 SRLExportMembers or –Wsrlexportmembers is ignored
and a warning is issued
 SRLName or –Wsrlname is ignored and a warning is issued

or have different behavior (Continued):
 INSPECT
 Controls the selection of the debugging tools.The order of
precedence follows:
 For S-series non-PIC:Visual Inspect, Inspect, DEBUG
 For S-series PIC:Visual Inspect, DEBUG
 For Integrity NonStop:Visual Inspect, Native Inspect
 NOINSPECT
 Controls the selection of the debugging tools.The order of
precedence follows:
 For S-series: DEBUG
 For Integrity NonStop: Native Inspect

or have different behavior (Continued):
 NLD or –Wnld is replaced with ELD or –Weld
respectively
 LD or –Wld is replaced with ELD or –Weld respectively
 VERSION1 replaced withVERSION2 orVERSION3
 –Wversion1 replaced with –Wversion2 or –Wversion3

Neutral C++ DialectNeutral C++ Dialect
◦ The neutral C++ dialect consists of library
components that are sharable betweenVERSION2
andVERSION3 of the C++ standard libraries
◦ Permits middleware to supportVERSION2 and
VERSION3 clients
◦ Two pragmas are provided in support of the neutral
C++ dialect:
 NEUTRAL: Marks a class definition as being sharable (allowed only in
standard header files)
 BUILD_NEUTRAL_LIBRARY: Used to create DLLs that use the
neutral dialect. If this pragma is specified and the program references
an object not marked with NEUTRAL, a compiler error is issued.

Other C/C++ MigrationTasksOther C/C++ MigrationTasks
◦ New C and C++ features
 Pragmas
 NEUTRAL: Marks an object as sharable betweenVERSION2
andVERSION3 of the C++ standard library
 BUILD_NEUTRAL_LIBRARY: Build a DLL using the neutral
C++ dialect
 MAXALIGN:Aligns composite objects to the16-byte
alignment, which is the maximum alignment supported by
the compiler for some functions to work. Most programs
will not need to declare the MAXALIGN pragma, as it is
included in the standard header file that supplies the data
type declaration.

◦ New C and C++ features (Continued)
 New 64-bit unsigned integer data type
 Type declaration is unsigned long long
 New functions for conversion between character
strings and the 64-bit integer type:
 strtoll — Converts a character string to a
signed long long integer
 strtoull — Converts a character string to an
unsigned long long integer
 wcstoll — Converts a wide-character string to a
signed long long integer
 wcstoull — Converts a wide-character string to an
unsigned long long integer

◦ Data type for 32-bit values in CEXTDECS file
changes from long to int
 When recompiling native TNS/R programs for the TNS/E
environment, if
 The parameter is passed by value: automatic type conversion is done
and no warning is issued
 The parameter is passed by reference: correct code is generated and
the warning of mismatched data types is issued
 One of the following actions may be taken, but is not
required:
 Use theWARN/NOWARN pragma or flag to suppress the warning
message
 Use the int type instead of the long type in the calling program
 Use __int32_t typedef for 32-bit items

◦ TNS/R and TNS/E systems use opposite conventions
for returning quiet and signaling NaN (not-a-number)
values
◦ Programs that depend on the TNS floating point
format must specify the TANDEM_FLOAT pragma
because the default floating-point format is IEEE
◦ Replace _TNS_R_TARGET feature test macro with
_TNS_E_TARGET
◦ Use _TANDEM_ARCH_ feature test macro to
identify the platform
 0 for TNS, 1 for TNS/R and 2 for TNS/E

TNS/E Native COBOL CompilerTNS/E Native COBOL Compiler
◦ Supports the same functions and features as
the TNS/R native COBOL compiler
◦ Compiles most TNS/R native COBOL
programs and executes them correctly
◦ Any program called by a migrated application
must also be migrated to TNS/E native mode
◦ All code produced by the compiler is PIC

COBOL Compiler DirectivesCOBOL Compiler Directives
◦ The following obsolete compiler directives
cause a warning to be issued if they are not
removed. No code change is required.
 NON-SHARED: In a TNS/E system, all code is
sharable PIC; therefore, this directive is ignored
 LARGEDATA: In a TNS/E system, there is no
distinction of data areas so this directive is ignored
 LESS-CODE: In a TNS/E system, native COBOL
does not support the option to use a system call to
initialize the Extended-Storage Section and this
directive has no effect

COBOL Compiler DirectivesCOBOL Compiler Directives
◦ The following compiler directives have different
meanings and changes may be required
 UL: Has the same effect as the SHARED directive. If used with
CALL-SHARED or SHARED, can cause an error. If used with
RUNNABLE, causes the compiler to link the object file into a DLL.
 SEARCH and CONSULT:
These must specify TNS/E object files
 OPTIMIZE:
 0 no optimization
 1 produces optimization for use with debugging
 2 produces full optimization
 INSPECT: If available, selectsVisual Inspect over Native
Inspect as the debugging tool
 NOINSPECT:
Selects Native Inspect as the debugging tool

Other COBOL Migration TasksOther COBOL Migration Tasks
◦ Use of floating-point data
 TNS/E native COBOL uses the IEEE format, not HP
proprietary TNS format
◦ Alignment of Level-01 and Level-77 data items
 are aligned on an 8-byte boundary
 can be aligned on an 4-byte boundary by adding the
SYNCHRONIZED clause to the declarations
◦ File names referenced in the following contexts are
changed from NMCOBEX<n> to ECOBEX<n>
where <n> is 0, 1 or T:
 CONSULT, LIBRARY, and SEARCH directives
 File-mnemonic clause of the SPECIAL-NAMES paragraph
 OF or IN clause of the CALL or ENTER statement

User Library MigrationTasksUser Library MigrationTasks
◦ The user library is an object file that the operating
system links to a program file at run time
◦ TNS/R native user libraries:
 Non-PIC user library is a special form of shared run-time
library (SRL)
 PIC user library is a dynamic-link library (DLL)
◦ TNS/E supports PIC user libraries only
◦ Migrating either type of TNS/R native user library
requires recompiling and relinking

◦ Migrating SRL-type of TNS/R native user library
 For pTAL programs
 Guardian environment: Use EPTAL with CALL_SHARED directive
on the command line
 PC: Use eptal with –shared flag on the command line
 For C/C++ programs
 Guardian environment: Use CCOMP or CPPCOMP
 OSS environment or PC: Use c89 with –Wshared flag. Replace SRL
with SHARED pragma
 For COBOL programs
 Guardian environment: Use ECOBOL with SHARED, ELD, and
RUNNABLE directives on the command line
(or in the source code)
 OSS environment or PC: Use ecobol

◦ Migrating DLL-type of TNS/R native user
library
 For all programs
 DLLs on TNS/E systems are functionally identical to DLLs
on TNS/R systems
 Recompile DLLs with TNS/E native compiler and link the
object codes with TNS/E eld linker using same compiler
directives and same linker flags

Floating-point Consistency ChecksFloating-point Consistency Checks
◦ Possible linkfile and loadfile floattype settings:
 TANDEM_FLOAT
 IEEE_FLOAT
 NEUTRAL_FLOAT
◦ Set by compiler or eld
◦ Checks performed:
 Link-time
 TANDEM_FORMAT and IEEE_FORMAT can not be linked together
 Override by setting floattype explicitly using eld
 Run-time
 Program file and Ordinary DLL must match or one be neutral
 Override by setting float_lib_overrule using eld

Guardian API Migration TasksGuardian API Migration Tasks
◦ Procedures having different behavior
 Different buffer alignment for GETPOOL and
POOL_GETSPACE_ procedures
 ForTNS/R native callers, the above procedures return pointers to
4-byte aligned buffers.
 ForTNS/E native callers, the above procedures return pointers to
16-byte aligned buffers by default
 Results may differ when the pool is already near capacity. It may
not be possible to allocate as many data blocks on aTNS/E system
as on aTNS/R system
 DEBUG and PROCESS_DEBUG_ procedure invokes H-
series debuggers
 Visual Inspect, Native Inspect, or Inspect

◦ Procedures having new return values
 PROCESSORTYPE procedure returns:
 10 indicating an EPIC processor
 PROCESSOR_GETNAME_ procedure returns:
 For name parameter: NSE-A
 For cpu-type-out parameter: 10
 For cpu-model-out parameter: 1 to 92*
 PROCESSOR_GETINFOLIST_ procedure returns:
 For processor type: 10
 For processor model number : 1 to 92*
 For processor name: NSE-x
 For processor full name: HP NonStop System EPIC Model x CPU
 Number of IPUs for NSMA
 TOSVERSION and REMOTETOSVERSION procedures
return the value of R06

◦ Superseded procedures
 The DELAY procedure is deprecated; it is superceded
by the PROCESS_DELAY_ procedure
◦ New procedures to support process
management enhancements
 PROCESS_DELAY_
 TIMER_START_
 TIMER_STOP_
 TS_NANOSECS_
 TS_UNIQUE_COMPARE_
 TS_UNIQUE_CONVERT_TO_JULIAN_
 TS_UNIQUE_CREATE_

Third-Party ToolsThird-Party Tools
Ensure that any third-party tools you use
are available for TNS/E systems:
◦ Development tools
◦ Code libraries
◦ Operations tools
 Schedulers
 Performance monitors
 Backups

Data Dictionary MigrationData Dictionary Migration
New DDL Compiler on TNS/E
◦ ?DICT
This dictionary was created by a different
version of the DDL compiler. It can be read but
not updated by this DDL compiler.
To convert your dictionary:
 ?DDL TEMP
 OUTPUT *
 ?NODDL, DICT! ,COMMMENTS, SOURCE TEMP

Mod05 application migration

More Related Content

What's hot (20)

Similar to Mod05 application migration (20)

Recently uploaded (20)

Mod05 application migration

Editor's Notes