Configuration Guide for OpenVMS

 

This document gives instructions for configuring the BEA ProductName for OpenVMS software.

 

Preparing for BEA MessageQ Implementation

BEA MessageQ Basic Concepts and Terms

Supported Network Protocols

Message Queues

BEA MessageQ Server Processes

Naming

Global Memory

BEA MessageQ / BEA TUXEDO Bridge

Configuring Distributed Systems Using BEA MessageQ

Design Paradigms

Traditional Functional Model

Object-Oriented Methodology

Determining Queue Sizes

Simulating Worst-Case Load Scenario

Failover Provisions

Design Summary

 

Defining the Message Queuing Environment

Preparing to Define the BEA MessageQ Environment

BEA MessageQ Manager Account Privileges

Basic Configuration Steps

Creating a Message Queuing Group

The BEA MessageQ Message Queuing Network

Assigning Bus and Group IDs

Creating Message Queuing Groups

Default Directory Names

Connecting to the BEA MessageQ Logical Name Table

Editing DMQ$INIT to Configure a Group

Setting Servers and Configuring Groups in the Profile Section

Profile Section Parameters

Default Namespace Path Definition

Setting Network Connections in the Cross-group Section

Configuring Client Library Server in the CLS section

Configuring Local Buffer Pools in the Buffer section

Defining Queues in the Queue Configuration Section

Setting Broadcast System Parameters in the SBS Section

Setting Message Recovery System Parameters in the MRS Section

Assigning the Groups in which the Naming Agent Will Run

Starting and Stopping BEA MessageQ Groups

Using DMQ$STARTUP to Invoke BEA MessageQ

Invoking DMQ$STARTUP without Starting the Servers

Starting Groups Under an Older Version of BEA MessageQ

Starting Application Programs in a Message Queuing Group

Application Startup Process

Two Methods for Connecting

Detaching a Process with DCL Context

Detaching a Process without DCL Context

Shutting Down a Running BEA MessageQ Group

Additional Configuration Tasks

Configuring Event Logging

Adding Queue Names to Network-wide Namespace

Changing Parameters in the Running Group

Deleting Groups

Defining Message Type and Class Codes

BEA MessageQ Hints and Tips

Modifying Your Default Editor

Defining BEA MessageQ Symbols

Startup Synchronization

Redirecting Configuration and Log Files

 

Configuring Cross-group Connections

Connecting to Other Message Queuing Groups

Configuring the Cross-group Connection Table

Cross-group Connection Table Overview

Loading the Configuration Data

Using Cross-group Connection Table Fields

Table Entry Guidelines

Using Message Routing

Routing Tables

Configuring and Loading the Tables

DMQ$INIT Routing Section

Selecting the TCP/IP Link Driver

Sharing Group Configuration Files

Suppressing DECnet Intrusion Alarms

Configuring DMQ$GMT_OFFSET for Network Communications

 

Configuring Message Queues and Global Memory

Configuring Message Queues

Queue Configuration Table Parameters

Queue Configuration Table Rules

Configuring Global Memory

How BEA MessageQ Uses Global Memory

Using the Buffer Pool Configuration Table

 

Configuring Message Recovery

How Message Recovery Services Work

Using Recoverable Journal Files

Using Auxiliary Journal Files

Using the Dead Letter Journal

Using the Post Confirmation Journal

Retrieving Journaled Messages

Starting MRS and JRN Servers

Configuring MRS and JRN Servers

Setting Parameters for MRS and JRN

How BEA MessageQ Manages Destination Queue Files (DQFs)

Specifying the Location of MRS Files

Sizing MRS File Space

Sizing the Amount of Recovery File Space

Sizing the Journal File Chunk Size

Sizing MRS Server In-Memory Data Structures at Startup

Reducing MRS Server Startup Time in Large-Scale Applications

MRS Internal Operation Tracing at Startup

Confirming Message Removal from the Recovery System

Using the CONFIRM_STYLE Attribute

Controlling Recovery System Response with DMQ$BLOCKING_CONFIRM

Using RCVR_ONLY_CONFIRM Parameter

 

Setting Up Selective Broadcasting

Overview of Selective Broadcasting

Starting the SBS Server

Configuring Broadcasting

Specifying Multipoint Outbound Target (MOT) Addresses

Configuring Optimized Ethernet Mode

Broadcasting Requirements and Restrictions

SBS Interoperability

Ethernet Broadcast Recovery Methods

Configuring Optimized Ethernet Mode

Dual-rail Mode

RP/ETH Retransmission Protocol

RP/ETH Receive Silo Rules

RP/ETH Examples

RP/ETH Configuration

 

Creating Global Names

Configuring BEA MessageQ Global Naming

Configure Groups to Run or Use the Naming Agent

Configure a Lightweight Namespace

Default Namespace Path Definition

Configure a Default Namespace Path for Each Group

Define the Queue Names in the Group Initialization File

Using DNS with Global Naming

Managing the Global Namespace

Viewing a Group's Cache

Global Name Examples

Defining Type and Class Codes

 

Configuring the BEA MessageQ Client Library Server

BEA MessageQ Client Library Server Overview

Client Library Server Installation and Transport Support

Configuring the CLS section of DMQ$INIT.TXT File

CLS Endpoints

Setting Maximum Number of Clients for CLS

Configuring One Client for Each CLS Server Option

Restricting Remote Access to CLS

Special Queue Configuration Issues

Errors Attaching to Undefined Queues

Starting and Stopping CLS Manually

Starting CLS from the Manager Utility

Starting CLS from DCL

Stopping CLS from the Manager Utility

CLS Event Logging and Tracing

 

BEA MessageQ Main Menu and Utilities

Using the BEA MessageQ Main Menu

Running the IVP

Starting and Shutting Down the COM Server

Verifying Buffer Pool Configuration (DMQ$LLS_VERIFY)

Testing BEA MessageQ Communications with DMQ$LOOP

Running DMQ$LOOP

Testing BEA MessageQ Services with DMQ$TEST

Running the CUSTOMIZE Command Procedure

Customization Options

About the DMQ$BOOT Command Procedure

About the DMQ$INIT.TXT File

About the DMQ$TYPCLS.TXT File

Running the DMQ$LOADER Utility

Starting the LOADER Utility

Restrictions on DMQ$LOADER

Changing Bus and Group Numbers

Shutting Down BEA MessageQ

 

Using BEA MessageQ System Management Utilities

Major System Management Tasks

Using the Monitor Utility (DMQ$MONITOR)

Displaying Queue Counters

Displaying Queue Quotas

Displaying COM Server Status

Displaying Queue-Specific Status

Resetting COM Server Counters

Displaying the Routing Table

Shutting Down COM Server Process

Displaying Link Summary Information

Displaying Link Detail Information

Displaying Link Connect Table

Displaying Group Detail Information

Resetting Cross-Group Connections

Displaying Remote Groups

Using the System Management Utility (DMQ$MGR_UTILITY)

Displaying Queue Summary Information

Displaying Queue Detail Information

Flushing Queues

Stopping Queues

Starting Queues

Forcing a Process to Exit

Redirecting Status and Trace Output

Enabling Tracing Prior to Starting a Program

Enabling Tracing When a Program is Running

Event Logging

Directing Error and Status Messages Prior to Starting a Program

Redirecting Error and Status Logging When a Program is Running

Using Event Log Control

Storing Event Data

Switching Event Log Files

Displaying Group Name Table

Journal Controls

Managing DQF and SAF Journals

Managing DLJ and PCJ Journals

Managing the Naming Agent and the Namespace

Displaying Information About Names and the Namespace

Managing Address and Name Associations

Removing Names from the Namespace

 

Sizing and Tuning the BEA MessageQ Environment

Sizing and Tuning Processes

Virtual Memory

Global Memory

I/O Channels

Files

Network Resources

Other System Resources and Quotas

Modifying DMQ$SET_SERVER_QUOTAS.COM

Allocating Virtual Memory for BEA MessageQ Servers

Modeling Virtual Memory Needs

Performing Testing

Modeling Memory Usage for Each BEA MessageQ Server

Example Memory Allocation Model for the MRS Server

Global Memory

Tuning TCP/IP for BEA MessageQ

Approximating the Nonpaged Pool Needs

Computing the Number of TCP/IP Sockets

Configuring BEA MessageQ for Large Messages

Maximum Message Size

Message Pool Configuration

Buffer Pool Parameter

Queue Quota

Global Section Size

Timeouts

Message Recovery Services

 

Managing a BEA MessageQ Environment

BEA MessageQ Error Logging

BEA MessageQ Output

BEA MessageQ Stream Output

Stream Destinations

Stream Switches

The Event Logger

Console Output

In-Memory Logging

Enabling Tracing

BEA MessageQ Servers

BEA MessageQ Server Output Files

BEA MessageQ Server Logging/Debugging

Tools for Troubleshooting BEA MessageQ Problems

Server Log Messages

API Return Status Values

Utility Programs

DMQ$TEST

DMQ$LOOP

DMQ$LLS_VERIFY

DMQ$MONITOR

DMQ$MGR_UTILITY

DMQ$SCAN_SYSTEM_FOR_DMQ.COM

Troubleshooting Procedures

Basic Troubleshooting Tasks

Diagnosing Application Errors

Enabling Server Tracing

Verifying BEA MessageQ Group Startup

Troubleshooting BEA MessageQ Startup Problems

Group Startup Failure

Additional Group Startup Problems

Troubleshooting Problems with Running Groups and Queues

BEA MessageQ Connectivity Troubleshooting

BEA MessageQ Recovery Troubleshooting

BEA MessageQ Application Troubleshooting

 

BEA MessageQ Security

Rights Identifiers Used By BEA MessageQ

Defining Access Control on Queues

Securing Readout of Permanent Queues

Securing the Creation of Temporary Queues

Setting the Global Section Protection Mask

Defining Protection Mask Logical Name

Setting ACLs for Global Sections

Controlling Network Access to Queuing Group

 

Managing Failover

Failover Mechanisms

Group Failover

Recoverable Queue Failover

Managing and Planning for Failover

Cold Failover

Hot Failover to a Running Shadow Group

Automatic Synchronized Cluster Failover

Implementing Automatic Synchronized Failover

Non-automatic Hot Failover

Implementing Non-Automatic Hot Failover

Detecting a Failure While the Failing Group Is Still Running

Programming Considerations

Failover of Recoverable Messaging to and from a Single Target

Redirecting Recoverable Data Streams

Merging Recoverable Data Streams

Supporting Failover of SAF Files

 

Configuring the BEA MessageQ Bridge

Enabling the Messaging Bridge

Target, Queue Space, and Queue Name Mapping

TUXEDO Queue Space to BEA MessageQ Group Name

TUXEDO Queue to BEA MessageQ Queue

 

Sample DMQ$INIT.TXT File

 

Sample DMQ$TYPCLS.TXT File

 

Parameter Tuning Guidelines

 

Directories and Logical Names

Directories

Logical Names

 

Error Log Messages

COM Server and Link Driver Error Log Messages

Additional Information on Link Drivers Error Status Reporting

MRS Server Error Log Messages

SBS Error Log Messages