Tuxedo

BEA Tuxedo
Programming a BEA Tuxedo
Application Using C

BEA Tuxedo Release 7.1
Document Edition 7.1
May 2000

Copyright
Copyright © 2000 BEA Systems, Inc. All Rights Reserved.

Restricted Rights Legend
This software and documentation is subject to and made available only pursuant to the terms of the BEA Systems
License Agreement and may be used or copied only in accordance with theterms of that agreement. It is against
the law to copy the software except as specifically allowed in the agreement. This document may not, in whole or
in part, be copied photocopied, reproduced, translated, or reduced to any electronic medium or machine readable
form without prior consent, in writing, from BEA Systems, Inc.
Use, duplication or disclosure by the U.S. Government is subject torestrictions set forth in the BEA Systems
License Agreement and in subparagraph (c)(1) of the Commercial Computer Software-Restricted Rights Clause
at FAR 52.227-19; subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at
DFARS 252.227-7013, subparagraph (d) of the Commercial Computer Software--Licensing clause at NASA FAR
supplement 16-52.227-86; or theirequivalent.
Information in this document is subject to change without notice and does not represent a commitment on the part
of BEA Systems. THE SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" WITHOUT
WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, BEA Systems DOES
NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONSREGARDING THE USE, OR THE
RESULTS OF THE USE, OF THE SOFTWARE OR WRITTEN MATERIAL IN TERMS OF CORRECTNESS,
ACCURACY, RELIABILITY, OR OTHERWISE.

Trademarks or Service Marks
BEA, ObjectBroker, TOP END, and Tuxedo are registered trademarks of BEA Systems, Inc. BEA Builder, BEA
Connect, BEA Manager, BEA MessageQ, BEA Jolt, M3, eSolutions, eLink, WebLogic, and WebLogic Enterprise
are trademarksof BEA Systems, Inc.
All other company names may be trademarks of the respective companies with which they are associated.
Programming a BEA Tuxedo Application Using C

Document Edition

Date

Software Version

7.1

May 2000

BEA Tuxedo Release 7.1

Contents
1. Introduction to BEA Tuxedo Programming
BEA Tuxedo Distributed Application Programming........................................ 1-1
Communication Paradigms ............................................................................... 1-3
BEA Tuxedo Clients.......................................................................................... 1-4
BEA Tuxedo Servers......................................................................................... 1-6
Basic ServerOperation............................................................................... 1-6
Servers as Requesters ................................................................................. 1-8
BEA Tuxedo API: ATMI .................................................................................. 1-9

2. Programming Environment
Updating the UBBCONFIG Configuration File................................................ 2-1Setting Environment Variables.......................................................................... 2-5
Including the Required Header Files................................................................. 2-8
Starting and Stopping the Application .............................................................. 2-8

3. Managing Typed Buffers
Overview of TypedBuffers............................................................................... 3-2
Allocating a Typed Buffer................................................................................. 3-6
Putting Data in a Buffer..................................................................................... 3-9
Resizing a Typed Buffer.................................................................................. 3-11...