Contents for Using the ATMI /Q Component
BEA Tuxedo /Q Overview
General Description
Queuing System Components and Tasks
Administrator Tasks
Programmer Tasks
Transaction Management
Handling Reply Messages
Error Handling
Summary
BEA Tuxedo /Q Administration
Introduction
Available Sample Program Called qsample
Configuration
Specifying the QM Server Group
Specifying the Message Queue Server
Operation Timeout
Queue Space Names, Queue Names, and Service Names
Data-dependent Routing
Customized Buffer Types
Buffer Subtypes
Specifying the Message Forwarding Server
Queue Names and Service Names: The -q option
Controlling Transaction Timeout: The -t option
Controlling Idle Time: The -i option
Controlling Server Exit: The -e option
Delete Message After Service Failure: The -d option
Customized Buffer Types
Dynamic Configuration
Creating Queue Spaces and Queues
Working with qmadmin Commands
Creating an Entry in the Universal Device List: crdl
Creating a Queue Space: qspacecreate
Creating a Queue: qcreate
Specifying Queue Order
Enabling Out-of-Order Enqueuing
Specifying Retry Parameters
Using Queue Capacity Limits
Reply and Failure Queues
Error Queues
Handling Encrypted Message Buffers
Maintenance of the BEA Tuxedo /Q Feature
Adding Extents to a Queue Space
Backing Up or Moving Queue Space
Moving the Queue Space to a Different Type of Machine
TMQFORWARD and Non-Global Transactions
TMQFORWARD and Commit Control
Handling Transaction Timeout
TMQFORWARD and Retries for an Unavailable Service
Windows Standard I/O
BEA Tuxedo /Q C Language Programming
Introduction
Prerequisite Knowledge
Where Requests Can Originate
Emphasis on the Default Case
Enqueuing Messages
tpenqueue(3c) Arguments
tpenqueue(): The qspace Argument
tpenqueue(): The qname Argument
tpenqueue(): The data and len Arguments
tpenqueue(): The flags Arguments
TPQCTL Structure
Overriding the Queue Order
Overriding the Queue Priority
Setting a Message Availability Time
tpenqueue() and Transactions
Dequeuing Messages
tpdequeue(3c) Arguments
tpdequeue(): The qspace Argument
tpdequeue(): The qname Argument
tpdequeue(): The data and len Arguments
tpdequeue(): The flags Arguments
TPQCTL Structure
Using TPQWAIT
Error Handling When Using TMQFORWARD Services
Procedure for Dequeuing Replies from Services Invoked Through TMQFORWARD
Sequential Processing of Messages
Using Queues for Peer-to-Peer Communication
BEA Tuxedo /Q COBOL Language Programming
Introduction
Prerequisite Knowledge
Where Requests Can Originate
Emphasis on the Default Case
Enqueuing Messages
TPENQUEUE() Arguments
TPENQUEUE(): The QSPACE-NAME in TPQUEDEF-REC Argument
TPENQUEUE(): The QNAME in TPQUEDEF-REC Argument
TPENQUEUE(): The DATA-REC and LEN in TPTYPE-REC Arguments
TPENQUEUE(): The Settings in TPQUEDEF-REC
TPQUEDEF-REC Structure
Overriding the Queue Order
Overriding the Queue Priority
Setting a Message Availability Time
TPENQUEUE() and Transactions
Dequeuing Messages
TPDEQUEUE() Arguments
TPDEQUEUE(): The QSPACE-NAME in TPQUEDEF-REC Argument
TPDEQUEUE(): The QNAME in TPQUEDEF-REC Argument
TPDEQUEUE(): The DATA-REC and LEN in TPTYPE-REC Arguments
TPDEQUEUE(): The Settings in TPQUEDEF-REC
TPQUEDEF-REC Structure
Using TPQWAIT
Error Handling When Using TMQFORWARD Services
Procedure for Dequeuing Replies from Services Invoked Through TMQFORWARD
Sequential Processing of Messages
Using Queues for Peer-to-Peer Communication
A Sample Application
Overview
Prerequisites
What Is qsample?
Building qsample
Suggestions for Further Exploration
setenv: Set the Environment
makefile: Make Your Application
ubb.sample: The ASCII Configuration File
crlog: Create the Transaction Log
crque: Create the Queue Space and Queues
Boot, Run, and Shut Down the Application
Clean Up