Sun Java logo     Copyright      Index      Next     

Sun logo
Sun Java System Message Queue 3.5 SP1 C Client Developer's Guide 


List of Figures

List of Tables

List of Procedures

Audience for This Guide
Organization of This Guide
Text Conventions
Directory Variable Conventions
Other Documentation Resources
The Message Queue Documentation Set
Online Help
Example Client Applications
The Java Message Service (JMS) Specification
Related Third-Party Web Site References

Chapter 1   Introduction
What Is Message Queue?
Message Queue Features
Java and C Interfaces
Product Editions
Message Queue Messaging System Architecture
The JMS Programming Model
Message Body Types
Message Producer
Message Consumer
Message Listener
Client Design Issues
Programming Domains
Client Identifiers
Reliable Messaging
Delivery Mode
Acknowledgements and Transactions
Persistent Storage
Performance Trade-offs
Message Production and Consumption
Message Production
Message Consumption
Synchronous and Asynchronous Consumption
Message Selection
Message Order and Priority
Configuring Connections
Connection Handling
Flow Control
Version Information
Managing Flow Control
Delivery Mode
Acknowledgement Mode
Message Flow Metering

Chapter 2   Building and Running Message Queue C Clients
Getting Ready
Building Programs
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

Chapter 3   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
Working With Secure Connections
Shutting Down Connections
Working With Sessions and Destinations
Creating a Session
Transacted Sessions
Message Acknowledgement
Receive Mode
Managing a Session
Creating Destinations
Working With Messages
Composing Messages
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
Thread Management
Message Queue C Runtime Thread Model
Concurrent Use of Handles
Single-Threaded Session Control
Connection Exceptions

Chapter 4   Reference
Data Types
Connection Properties
Acknowledge Modes
Callback Type for Asynchronous Messaging
Callback Type for Connection Exception Handling
Function Reference
Header Files

Appendix A   Message Queue C API Error Codes
Error Codes


Copyright      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.