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