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

ManualsBrandsHP ManualsServerHP NonStop G-Series

641

642

643

644

645

646

647

648

649

650

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

RUNNAMED pragma 13-80

Running a C program 19-1, 19-2

Run-time

environment 7-2, 14-10

errors and warnings 22-1

libraries 9-1, 14-12, 19-3, B-5

initialization 16-14, 17-13

rwstdex header 5-8

Sample C++ program 15-10

SAVEABEND pragma 13-82

SCF user interface

misalignment handling and 23-3

misalignment tracing facility and 23-2

SEARCH pragma 13-84, 15-6

Search subvolumes 13-96

SECTION pragma 13-85, 15-3

SEGMENT_ALLOCATE_ procedure 7-27

SEGMENT_DEALLOCATE_

procedure 7-27

SEGMENT_USE_ procedure 7-27

SHARED pragma 13-86

Shared run-time libraries

See SRLs

Sharing data

C data with pTAL modules using

pointers 8-14

C data with TAL modules

using pointers 7-15

C data with TAL modules using BLOCK

declarations 7-17, 8-15

pTAL and C guidelines 8-6

pTAL data with C modules

using BLOCK declarations 8-15

TAL and C general guidelines 7-14

TAL data with C modules

using BLOCK declarations 7-17

using pointers 7-14, 8-13

SIGILL signal (signal #4) 23-4

Signals, native C A-6

Signals, TNS C A-21

signed char type 2-21

16-bit data model

TNS/E native C++ compiler 1-14

TNS/E natrive C compiler 1-13

TNS/R native C compiler 1-5

TNS/R native C++ compiler 1-6

sizeof instruction 23-6

SLMAP file 5-12

Small-memory model 1-5, 1-13, 3-6,

13-116, 19-7

Source files, acceptable types of 14-6,

16-12, 17-11

Specifying

header files 14-3, 16-3, 17-3

library files 14-8, 14-16

SQL data-type conversion functions 4-11

SQL pragma 13-87

SQLMEM pragma 13-91

SQL/MP compiler 1-3, 1-10, 1-17, 14-13

SQL/MX compiler 1-10, 1-17

SRL pragma 13-92

SRLExportClassMembers pragma 13-92

SRLExports pragma 13-94

SRLName pragma 13-95

SRLs

description of 16-13

DLL 17-13

guidelines 13-79, 13-110

limitations of 14-9

linking in 16-14

required SRLs 16-14, 17-14

SSV pragma

CPATHEQ 13-16

in guardian environment 16-4, 17-4

SSV 13-96