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

ManualsBrandsHP ManualsServerHP NonStop G-Series

631

632

633

634

635

636

637

638

639

640

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-3

run-time library (continued)

TNS/E Native 1-14

TNS/R native 1-6

using c 4-1

standard 1-1

TAL and C guidelines 7-7

Tandem extensions

components 1-13

TNS/R Native 1-5

c89 utility

flags 14-13, 15-15

generating TNS/R code on NonStop

NS-series systems 16-1, 17-1

input files 15-17

operands 14-13, 15-16

OSS environment 14-12, 15-14

RVU pragma 13-82

syntax 14-13

Calling procedures

C calling TAL 7-11, 8-9

pTAL calling C 8-8

TAL calling C 7-10

CALL_SHARED pragma

description of 13-12

example 16-18, 17-17

Capabilities 11-1

Casting of pointers 2-17

Catastrophe messages 21-1

CCE macro 2-8

CCG macro 2-8

CCL macro 2-8

CCOMP command syntax 17-10

CCPLMAIN file 13-13, 17-12, 17-13

CCPPMAIN file 13-13, 16-13

cextdecs header 3-1, 7-6, 8-5

Cfront

compilation steps 1-4, 15-14

C++ translator 15-1, 15-6

extension, signed char 2-21

RUN command 15-7

char arrays 23-6

char variables, pTAL and C mixed

programming 8-17

char variables, TAL and C mixed

programming 7-18

Characters, user-defined features A-17

CHECK pragma 13-13, 15-3

Check-sum functions 23-7

CLARGE file 14-9, 15-13

Class libraries, TNS C++ B-3

CLIB file 14-9

CNONSTOP file 14-9

COBOL 2-10

Code space, specifying 9-1

Codewright 18-8

COLUMNS pragma 13-14, 15-3

Command line syntax

description of 14-4

Guardian environment 16-10, 17-10,

19-1

TNS C compiler 15-8

COMMON Binder group 14-10

Common Run-Time Environmen (CRE)

See CRE

Common Run-Time Library 19-3

Common-Usage C 1-5, 1-13, 1-22

Compiler

C 1-5, 1-13

C++ 1-5, 1-13

definition 1-1, 14-13

errors and warnings 20-1

pragmas 13-1