Sun Java logo     Copyright      Index      Next     

Sun logo
Sun Java System Message Queue 3 2005Q1 Developer's Guide for C Clients 

Contents


List of Tables

List of Procedures

Preface
Who Should Use This Book
Before You Read This Book
How This Book Is Organized
Conventions Used in This Book
Text Conventions
Directory Variable Conventions
Related Documentation
The Message Queue Documentation Set
Online Help
Example Client Applications
The Java Message Service (JMS) Specification
Related Third-Party Web Site References
Sun Welcomes Your Comments

Chapter 1   Introduction
Message Queue for the C Developer
Building and Running C Clients
Building C Clients
Header Files and Shared Libraries
Pre-Processor Definitions
C++ Runtime Library Support
Providing Runtime Support
Working With the Sample C-Client Programs
Building the Sample Programs
To Compile and Link on Solaris
To Compile and Link on Linux
To Compile on Windows
To Link on Windows
Running the Sample Programs
Client Application Deployment Considerations

Chapter 2   Using the C API
Message Queue C Client Setup Operations
To Set Up a Message Queue C Client to Produce Messages
To Set Up a Message Queue C Client to Consume Messages Synchronously
To Set Up a Message Queue C Client to Consume Messages Asynchronously
Working With Properties
Setting Connection and Message Properties
To Set Properties for a Connection
To Set Message Properties
Getting Message Properties
To Iterate Through a Properties Handle
Working With Connections
Defining Connection Properties
Connection Handling
Reliability
Flow Control
Working With Secure Connections
Configuring the Client for Secure Communication
Verification Using Fingerprints
To Set Up Fingerprint Certification, Do the Following:
Coordinating NSS Initialization
To Coordinate NSS Initialization
Shutting Down Connections
Working With Sessions and Destinations
Creating a Session
Transacted Sessions
Message Acknowledgement
Receive Mode
Managing a Session
Creating Destinations
Programming Domains
Auto-Created Destinations
Temporary Destinations
Getting Information About Destinations
Working With Messages
Composing Messages
Message Header
Message Body Types
Composing the Message
Sending a Message
Receiving Messages
Working With Consumers
Receiving a Message Synchronously
Receiving a Message Asynchronously
Processing a Message
Error Handling
To Handle Errors in Your Code
Memory Management
Logging

Chapter 3   Client Design Issues
Producers and Consumers
Using Selectors Efficiently
Determining Message Order and Priority
Managing Threads
Message Queue C Runtime Thread Model
Concurrent Use of Handles
Single-Threaded Session Control
Connection Exceptions
Managing Physical Destination Limits
Managing the Dead Message Queue
Factors Affecting Performance
Delivery Mode (Persistent/Non-persistent)
Use of Transactions
Acknowledgement Mode
Durable vs. Non-Durable Subscriptions
Use of Selectors (Message Filtering)
Message Size
Message Body Type

Chapter 4   Reference
Data Types
Connection Properties
Acknowledge Modes
Callback Type for Asynchronous Messaging
Callback Type for Connection Exception Handling
Function Reference
Setting a Client Identifier
Handling Connection Exceptions
Header Files

Appendix A   Message Queue C API Error Codes
Error Codes

Index


Copyright      Index      Next     


Part No: 819-0067-10.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.