Client for UNIX User's Guide

 

This document provides instructions on installing, configuring, and using the MessageQ Client to run MessageQ applications. The MessageQ Client provides applications with the full support of MessageQ features, while using significantly fewer resources than a full message server.

 

Introduction

What is the MessageQ Client?

Benefits of Using the MessageQ Client

Architectural Overview

The Client Library Server

How the MessageQ Client and CLS Work Together

 

Installing the MessageQ Client

Preinstallation Requirements

Software Requirements

Disk Space Requirements

Backing Up Your System Disk

Choosing Installation Options

Installing the MessageQ Client for UNIX Software

Recovering from Errors During the Installation

Adding the Initialization File Directory to Your PATH

 

Configuring the MessageQ Client

Configuring the Server Connection

Default Server

Automatic Failover Server

Configuring Logging

Configuring Message Recovery Services

Configuring Tracing

Testing the Configuration Using the Test Utility

 

Using the MessageQ Client for UNIX

Overview of the MessageQ Client Utilities

Developing Your MessageQ Client Application

MessageQ API Support

MessageQ Client Function Parameter Limits

Include Files for C and C++

MessageQ Client Return Codes

Byte Order Considerations for Application Developers

Sample Programs

Running Your Application

Run-time Files

Managing Your Application

MRS Utility

 

Troubleshooting

Determining the Version Number of the Client

Identifying Run-time Errors

Logging an Error Event

Failing to Connect to the CLS

Identifying Network Errors

Tracing PAMS API Activity

Tracing Client Library Activity

Recovering from Client Crashes