gtpa2m07 | Application Programming |
This book describes IBM C and C++ language support for Transaction
Processing Facility (TPF) application programming. It includes chapters
about TPF application programming, writing TPF application programs in C, C++,
and assembler, coding library functions, and debugging. Although this
book is primarily directed toward application programmers, introductory and
reference sections will also be of interest to TPF system programmers and
customer system and middleware programmers. Tools providers will also
see a need for the information in this book. It also serves as a
user's guide to application programming in the TPF operating
system.
For details about the C and C++ language functions referenced in this book,
see the TPF C/C++ Language Support User's
Guide. For details about the C language functions that are
provided with Transmission Control Protocol/Internet Protocol (TCP/IP)
support, see TPF Transmission Control Protocol/Internet
Protocol. For details about the assembler language macros, see
TPF General Macros.
In this book, abbreviations are often used instead of spelled-out
terms. Every term is spelled out at first mention followed by the
all-caps abbreviation enclosed in parentheses; for example, Systems
Network Architecture (SNA). Abbreviations are defined again at various
intervals throughout the book. In addition, the majority of
abbreviations and their definitions are listed in the master glossary in the
TPF Library Guide.
This book is intended for:
- Application programmers who already understand some general TPF
programming concepts. It offers guidance on how to apply knowledge of
assembler, C, and C++ languages to programming in the TPF system
environment.
- Webmasters who want to use the TPF system as a Web server site. It
offers guidance on how to use Internet server applications, how to port an
application to the TPF system that is compliant with the Portable Operating
System Interface for Computer Environments (POSIX) standards, and how to start
a TPF application from the Internet.
These users are expected to be programmers who have some familiarity with
the TPF system, POSIX standards, UNIX, and the Internet.
The TPF library uses the following conventions:
Conventions
| Examples of Usage
|
italic
|
Used for important words and phrases. For example:
A database is a collection of data.
Used to represent variable information. For example:
Enter ZFRST STATUS MODULE mod, where mod is the
module for which you want status.
|
bold
| Used to represent text that you type. For example:
Enter ZNALS HELP to obtain help information for the ZNALS
command.
Used to represent variable information in C language. For
example:
level
|
monospaced
| Used for messages and information that displays on a screen. For
example:
PROCESSING COMPLETED
Used for C language functions. For example:
maskc
Used for examples. For example:
maskc(MASKC_ENABLE, MASKC_IO);
|
bold italic
| Used for emphasis. For example:
You must type this command exactly as shown.
|
Bold underscore
| Used to indicate the default in a list of options. For
example:
Keyword=OPTION1 | DEFAULT
|
Vertical bar |
| Used to separate options in a list. (Also referred to as the OR
symbol.) For example:
Keyword=Option1 | Option2
- Note:
- Sometimes the vertical bar is used as a pipe (which allows you to
pass the output of one process as input to another process). The
library information will clearly explain whenever the vertical bar is used for
this reason.
|
CAPital LETters
| Used to indicate valid abbreviations for keywords. For
example:
KEYWord=option
|
Scale
| Used to indicate the column location of input. The scale begins at
column position 1. The plus sign (+) represents increments of 5
and the numerals represent increments of 10 on the scale. The first
plus sign (+) represents column position 5; numeral 1 shows column
position 10; numeral 2 shows column position 20 and so on. The
following example shows the required text and column position for the image
clear card.
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
LOADER IMAGE CLEAR
Notes:
- The word LOADER must begin in column 1.
- The word IMAGE must begin in column 10.
- The word CLEAR must begin in column 16.
|
A list of related information follows. For information on how to
order or access any of this information, call your IBM representative.
- TPF ACF/SNA Data Communications Reference,
SH31-0168
- TPF Application Programming, SH31-0132
- TPF Application Requester User's Guide,
SH31-0133
- TPF C/C++ Language Support User's Guide,
SH31-0121
- TPF Concepts and Structures, GH31-0139
- TPF Database Reference, SH31-0143
- TPF Data Communications Services Reference,
SH31-0145
- TPF General Macros, SH31-0152
- TPF General Information, GH31-0147
- TPF Library Guide, GH31-0146
- TPF Main Supervisor Reference, SH31-0159
- TPF Migration Guide: Program Update Tapes,
GH31-0187
- TPF Operations, SH31-0162
- TPF Program Development Support Reference,
SH31-0164
- TPF Programming Standards, SH31-0165
- TPF System Generation, SH31-0171
- TPF System Installation Support Reference,
SH31-0149
- TPF System Macros, SH31-0151
- TPF System Performance and Measurement
Reference, SH31-0170
- TPF Transmission Control Protocol/Internet
Protocol, SH31-0120.
- IBM Systems Network Architecture Format and Protocol
Reference Manual: Architecture Logic for LU Type 6.2,
SC30-3269
- IBM Systems Network Architecture LU 6.2
Reference: Peer Protocols, SC31-6808
- IBM Systems Network Architecture Transaction
Programmer's Reference Manual for LU Type 6.2,
GC30-3084.
- MQSeries Application Programming Reference,
SC33-1673
- MQSeries Clients, GC33-1632
- MQSeries Distributed Queue Management Guide,
SC33-1139
- MQSeries for AIX Application Programming
Reference, SC33-1374
- MQSeries for OS/2 Application Programming
Reference, SC33-1370
- MQSeries for MVS/ESA Application Programming
Reference, SC33-1212
- MQSeries Message Queue Interface Technical
Reference, SC33-0850.
- C/C++ for MVS/ESA V3R2 Language Reference,
SC09-2150
- C/C++ for MVS/ESA V3R2 Library Reference,
SC23-3881
- C/C++ for MVS/ESA V3R2 Programming Guide,
SC09-2164
- C/C++ for MVS/ESA V3R2 User's Guide,
SC09-2205
- IBM C/370 Diagnosis Guide and Reference,
LY09-1804
- IBM C/370 Programming Guide, SC09-1384
- IBM C/370 User's Guide, SC09-1264
- OS/390 C/C++ IBM Open Class Library Reference,
SC09-2364
- OS/390 C/C++ IBM Open Class Library User's
Guide, SC09-2363
- OS/390 C/C++ Language Reference, SC09-2360
- OS/390 C/C++ Programming Guide, SC09-2362
- OS/390 C/C++ Run-Time Library Reference,
SC28-1663
- OS/390 C/C++ User's Guide, SC09-2361
- Programming Guide SAA AD/Cycle C/370,
SC09-1841
- Programming Guide SAA AD/Cycle Language
Environment/370, SC09-1840
- SAA AD/Cycle C/370 Language Reference,
SC09-1762
- SAA AD/Cycle C/370 Library Reference,
SC09-1761
- SAA AD/Cycle C/370 User's Guide,
SC09-1763
- SAA Common Programming Interface C Reference - Level
2, SC09-1308.
- AIX Version 4.1 Commands Reference,
SBOF-1851
- Character Data Representation Architecture Reference
and Registry, SC09-2190
- DFSMS/MVS Version 1 Release 2 Access Method Services
for VSAM Catalogs, SC26-4905
- ESA/370 Principles of Operation, SA22-7200
- ESA/390 Principles of Operation, SA22-7201
- Language Environment for MVS & VM Programming
Reference, SC26-3312
- Language Environment for MVS & VM Programming
Guide, SC26-4818
- MVS/XA VSAM Administration: Macro Instruction
Reference, GC26-4016
- 370/XA Principles of Operation,
SA22-7085.
- Internet Architecture Board Standard 33, Request for Comments
1350
- OSF DCE Application Development Reference (1993, Prentice
Hall), ISBN 0-13-643834-2
- UNIX Network Programming (1990, Prentice Hall) by W.
Richard Stevens, ISBN 0-13-949876-1
- UNIX Network Programming: Networking APIs: Sockets and
XTI (2nd Edition, 1997, Prentice Hall) by W. Richard Stevens,
ISBN 0-13-490012-X.
Your feedback is important in helping to provide the most accurate and
highest quality information. If you have any comments about this book
or any other TPF information, use one of the methods that follow. Make
sure you include the title and number of the book, the version of your product
and, if applicable, the specific location of the text you are commenting on
(for example, a page number or table number).
When you send comments to IBM, you grant IBM a nonexclusive right to use or
distribute your comments in any way it believes appropriate without incurring
any obligation to you.
- If you prefer to send your comments electronically, do either of the
following:
- If you prefer to send your comments by mail, address your comments
to:
IBM Corporation
TPF Systems Information Development
Mail Station P923
2455 South Road
Poughkeepsie, NY 12601-5400
USA
- If you prefer to send your comments by FAX, use this number:
- United States and Canada: 1 + 845 + 432 + 9788
- Other countries: (international code) + 845 + 432 +9788