Client for OpenVMS User's Guide

 

This document provides an introduction to the BEA MessageQ Client for OpenVMS and provides instructions on installing, configuring, using, and troubleshooting the BEA MessageQ Client for OpenVMS software.

 

Introduction

What is the BEA MessageQ Client?

Benefits of Using the BEA MessageQ Client

Architectural Overview

The Client Library Server

How the BEA MessageQ Client and CLS Work Together

 

Installing the BEA MessageQ Client

Installation Prerequisites

Hardware Requirements

Software Requirements

Disk Space Requirements

Backing Up Your System Disk

Installing the BEA MessageQ Client Software on OpenVMS Systems

Step 1--Run the VMSINSTAL procedure

Step 2--Select kit items for installation

Step 3--Postinstallation tasks

Recovering from Errors During the Installation

Postinstallation Tasks

Run the DMQ$CL_STARTUP Procedure

Configuring the BEA MessageQ Client

Initializing the BEA MessageQ Client Environment

 

Configuring the BEA MessageQ Client

Configuration Options, Parameters, and Menus

Configuring the Server Connection

Default Server

Automatic Failover Server

Configuring Message Recovery Services

Configuring Logging

Configuring Tracing

Testing the Configuration Using the Test Utility

 

Using the BEA MessageQ Client

Developing Your BEA MessageQ Client Application

BEA MessageQ API Support

BEA MessageQ Client Function Parameter Limits

Include Files for C and C++

BEA MessageQ Client Return Codes

Byte Order Considerations for Application Developers

Building Your Client Applications

Linking Applications with the BEA MessageQ Runtime Library

Linking Applications with the BEA MessageQ Object Library

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

Decoding TCP/IP Error Codes

Tracing PAMS API Activity

Tracing Client Library Activity

Recovering from Client Crashes