C/C++ Programmer's Guide (G06.27+, H06.03+)

ManualsBrandsHP ManualsServerHP NonStop G-Series

643

644

645

646

647

648

649

650

651

652

Table Of Contents

What’s New in This Manual
- Manual Information
- New and Changed Information
  - Changes to This Manual
  - Changes to Previous Revisions of This Manual
About This Guide
- Audience
- Documentation Set Organization
- Related Manuals
- Guide Organization
- Notation Conventions
1 Introduction to HP C and C++ for NonStop Systems
- TNS C Language System
- TNS C++ Language System
  - Exception Handling Is Not Supported
  - Compilation Steps for C++ Code
- TNS/R Native C and C++ Language System
- Features of TNS/R Native C and C++
- TNS/E Native C and C++ Language System
- Features of TNS/E Native C and C++
- Writing Portable Programs
  - Complying With Standards
  - Following Good Programming Practices
- Porting Programs to HP C and C++ for NonStop Systems
- Porting Without Data Alignment Problems
- Guardian and OSS Environment Interoperability
2 C and C++ Extensions
- Keywords
- Declarations
- Pointer Modifiers
- Operators
- Data Types
3 Interfacing to Guardian Procedures and OSS Functions
- Declaring Guardian Procedures
- Calling Guardian Procedures
- Declaring OSS Functions
4 Using the C Run-Time Library
- Versions of the C Run-Time Library
- Input/Output Models
- Mathematical Functions
  - IEEE Floating-Point Arithmetic
- Active Backup Programming Functions
- Environment-Specific Functions
  - Changes Required to Interoperable Compilation Modules at D44
- EDIT File Functions
- SQL Data-Type Conversion Functions
- Startup Information Retrieval Functions
- Miscellaneous HP Extension Functions
5 Using the Standard C++ Library
- User Documentation
- Features of the Standard C++ Library (VERSION3)
- Contents of the Standard C++ Library
- Installation Notes for VERSION3
  - Using Header Files With VERSION3
- Installation Notes for VERSION2
  - Examples of VERSION2 Headers
  - VERSION2 Standard C++ Library Example Files
- Compiling and Linking in the OSS Environment
- Pragmas for the Standard C++ Library
- Using the Neutral C++ Dialect
6 Accessing Middleware Using HP C and C++ for NonStop Systems
- Using Tools.h++
7 Mixed-Language Programming for TNS Programs
- Introducing the CRE
- Using Standard Files in Mixed-Language Programs
- Writing Interface Declarations
  - Examples
- Interfacing to TAL
- Interfacing to TNS COBOL
8 Mixed-Language Programming for TNS/R and TNS/E Native Programs
- Introducing the CRE
- Using Standard Files in Mixed-language Programs
- Declaring External Routines
- Considerations When Interfacing to pTAL
- Differences Between Native and TNS Mixed- Language Programs
- Interfacing to Native COBOL
9 System-Level Programming
- Specifying a Code Space
- Passing Pointers to Constants Between Code Spaces
- Writing Variable and Extensible Functions
10 Converting C-Series TNS Programs to Use the Current TNS Compiler
11 Migrating Programs to TNS/R or TNS/E Native Mode
12 Preprocessor Directives and Macros
- #define
- #error
- #if, #elif, #ifdef, #ifndef, #else, and #endif
- #include
- #line
- #pragma
- #undef
- Predefined Macros
- Predefined Symbols
- Variadic Macros
- Feature-Test Macros
- Preprocessor Operators
  - Operator #
  - Operator ##
13 Compiler Pragmas
- ALLOW_CPLUSPLUS_COMMENTS
- ALLOW_EXTERN_EXPLICIT_INSTANTIATION
- ANSICOMPLY
- ANSISTREAMS
- BUILD_NEUTRAL_LIBRARY
- CALL_SHARED
- CHECK
- COLUMNS
- CPATHEQ
- CPPONLY
- CSADDR
- ELD(arg)
- ENV
- ERRORFILE
- ERRORS
- EXTENSIONS
- EXTERN_DATA
- FIELDALIGN
- FORCE_VTBL
- FORCE_STATIC_TYPEINFO
- FORCE_STATIC_VTBL
- FUNCTION
- HEADERS
- HEAP
- HIGHPIN
- HIGHREQUESTERS
- ICODE
- IEEE_FLOAT
- INLINE
- INLINE_COMPILER_GENERATED_FUNCTIONS
- INLINE_LIMIT
- INLINE_STRING_LITERALS
- INNERLIST
- INSPECT
- KR
- LARGESYM
- LD(arg)
- LINES
- LINKFILE
- LIST
- LMAP
- MAP
- MAPINCLUDE
- MAXALIGN
- MIGRATION_CHECK
- NEST
- NEUTRAL
- NLD(arg)
- NOEXCEPTIONS
- NON_SHARED
- OLDCALLS
- OLIMIT
- ONCE
- OPTFILE
- OPTIMIZE
- OVERFLOW_TRAPS
- PAGE
- POOL_STRING_LITERALS
- POP
- PUSH
- REFALIGNED
- REMARKS
- RUNNABLE
- RUNNAMED
- RVU
- SAVEABEND
- SEARCH
- SECTION
- SHARED
- SQL
- SQLMEM
- SRL
- SRLExportClassMembers
- SRLExports
- SRLName
- SSV
- STDFILES
- STRICT
- SUPPRESS
- SUPPRESS_VTBL
- SYMBOLS
- SYNTAX
- SYSTYPE
- TANDEM_FLOAT
- TRIGRAPH
- VERSION1
- VERSION2
- VERSION3
- WARN
- WIDE
- XMEM
- XVAR
14 Compiling, Binding, and Accelerating TNS C Programs
- Selecting a Development Platform
- Specifying Header Files
- Working in the Guardian Environment
- Working in the OSS Environment
15 Compiling, Binding, and Accelerating TNS C++ Programs
- Working in the Guardian Environment
- Working in the G-Series OSS Environment
16 Compiling and Linking TNS/R Native C and C++ Programs
- Selecting a Development Platform
- Specifying Header Files
- Compiling and Linking Floating-Point Programs
  - Using Compiler Pragmas IEEE_Float and Tandem_Float
  - Using Link Options to Specify Floating-Point Format
- Working in the Guardian Environment
  - Compiling a Module
  - Linking a TNS/R Module
17 Compiling and Linking TNS/E Native C and C++ Programs
- Selecting a Development Platform
- Specifying Header Files
- Compiling and Linking Floating-Point Programs
  - Using Compiler Pragmas IEEE_Float and Tandem_Float
  - Using Link Options to Specify Floating-Point Format
- Working in the Guardian Environment
  - Compiling a Module
  - Linking a TNS/E Module
18 Using ETK and Native C/C++ Cross Compiler on the PC
- ETK
- TDS
  - Hardware and Software Requirements
  - Online Help
- Cross Compilers
- PC Tools
19 Running and Debugging C and C++ Programs
- Running Programs in the Guardian Environment
- Running Programs in the OSS Environment
- Program Initialization
- Program Termination
- Two Memory Models: Large and Small
  - Small-Memory Model
  - Large-Memory Model
- Two Data Models: 16-Bit and 32-Bit
- Selecting Memory and Data Models
- Converting Programs to the 32-Bit Data Model
- Debugging C and C++ Programs
20 TNS C Compiler Messages
- Types of Compiler Messages
21 Native C and C++ Compiler Messages
22 Run-Time Messages
- Trap and Signal Messages
- CRE Service Function Messages
- Heap-Management Messages
- Function Parameter Message
- Math Function Messages
- Function Parameter Messages
- Input/Output Messages
- Environment Messages
23 Handling TNS Data Alignment
- Misalignment Tracing Facility
- Misalignment Handling
- C/C++ Misalignment Examples
A HP C Implementation-Defined Behavior
- Implementation-Defined Behavior of Native C
- Translation Limits for Native C Compilers
- Implementation-Defined Behavior of TNS C
B TNS C++ ImplementationDefined Behavior
- HP Specific Features for OSS and Guardian Environments
- HP Specific Features for the Guardian Environment
  - Mixed-Language Programming
  - System-Level Programming
- Differences Between OSS and Guardian Environments
C ASCII Character Set
- Overview
- ASCII Character Set in Numeric Order
- ASCII Character Set in Alphabetic Order
D Data Type Correspondence
E Features and Keywords of Version2NativeC++
- Features Supported in VERSION2
- Features Not Supported in VERSION2
- Keywords Added for the D45 Product Release
- Defining Virtual Function Tables
F MIGRATION_CHECK Messages
- Code Examples
Glossary
Index

Index

HP C/C++ Programmer’s Guide for NonStop Systems—429301-010

Index-17

Special Characters

ZSTLSRL 13-112, 16-15, 16-17, 17-14

ZSYSC file 3-2

ZTLH7DLL 17-16

ZTLHSRL 16-17

ZUTILDLL 17-16

ZUTILSRL 16-17

Special Characters

$RECEIVE 4-5

-Wcplusplus 5-12

-Wnld_obey option 13-108

-Wtarget=TNS/R flag 16-1, 17-1

_alias attribute 2-12

_arg_present() operator 2-18, 9-5

_baddr pointer modifier 2-15

_bitlength() operator 2-18

_BOOL feature-test macro 12-13

_cc_status 2-7, 8-5

_cspace type qualifier 2-9, 9-4

_extensible attribute 2-12, 8-6

_far pointer modifier 2-15

_GUARDIAN_HOST macro 12-15

_GUARDIAN_TARGET macro 12-15

_IGNORE_LOCALE macro 12-15

_lowmem storage class specifier 2-2

_near pointer modifier 2-15

_optional() operator 2-19

_OSS_TARGET 12-15

_OSS_TARGET macro 12-15

_POSIX_C_SOURCE macros 1-20, 12-15

_POSIX_SOURCE macro 12-15

_procaddr pointer modifier 2-15

_resident attribute 2-13

_status_eg(x) macro 2-8

_status_gt(x) macro 2-8

_status_lt(x) macro 2-8

_TANDEM_SOURCE macro 1-20, 12-15

_variable attribute 2-14, 8-6

_waddr pointer modifier 2-15

_XOPEN_SOURCE macro 1-20, 12-15

_XOPEN_SOURCE_EXTENDED

macro 1-20, 12-15

__CPLUSPLUS feature-test macro 12-13

__DATE__ predefined macro 12-11

__FILE__ predefined macro 12-11

__FUNCTION__ predefined macro 12-11

__G_SERIES_RVU feature-test

macro 12-14

__H_SERIES_RVU feature-test

macro 12-14

__INT32__ predefined symbol 12-12

__LINE__ predefined macro 12-11

__ns_backup_fopen function 4-9

__ns_fget_file_open_state function 4-9

__ns_fget_file_state function 4-9

__ns_fopen_special function 4-9

__ns_fset_file_state function 4-9

__ns_start_backup function 4-9

__STDC__ predefined macro 12-11

__TANDEM__ predefined symbol 12-12

__TIME__ predefined macro 12-11

__XMEM__ predefined symbol 12-12