CONTENTS

  Title Page

  Copyright Page

  Preface

  1      Overview of DECmessageQ

  1.1     DECmessageQ
    1.1.1      DECmessageQ for VMS
    1.1.2      DECmessageQ for Other Supported Platforms

  1.2     DECmessageQ Messaging Environment
    1.2.1      Message Queuing Bus
    1.2.2      Message Queues
    1.2.3      Message Queuing Groups
      1.2.3.1      COM Server
      1.2.3.2      SBS Server
      1.2.3.3      MRS Server
      1.2.3.4      Global Memory

  1.3     Planning a Distributed System
    1.3.1      Defining Message Queuing Groups
    1.3.2      Defining the Message Queuing Bus

  1.4     DECmessageQ Configuration Management

  1.5     Migrating from the PAMS Message Queuing Bus to DECmessageQ

  2      Getting Started with a New Installation

  2.1     DECmessageQ Manager Account

  2.2     Accessing the DECmessageQ Main Menu

  2.3     Creating a Message Queuing Group
    2.3.1      Assigning a Bus ID
    2.3.2      Executing DMQ$CREATE_GROUP

  2.4     Setting Up the DECmessageQ Environment

  2.5     Editing the Configuration Files
    2.5.1      Editing DMQ$INIT.TXT
    2.5.2      Editing the Cross-Group Connection Table

  2.6     Starting Up and Shutting Down the DECmessageQ Servers

  2.7     Accessing the Message Queuing Group

  2.8     Defining VMS Symbols

  3      Creating Groups and Cross-Group Connections

  3.1     Managing DECmessageQ

  3.2     Creating Message Queuing Groups
    3.2.1      Directing MRS Files
    3.2.2      Directing DECmessageQ Console Messages
    3.2.3      Translating DECmessageQ Messages

  3.3     Providing Access to Message Queuing Groups

  3.4     Modifying Group Configuration Files with DMQ$CUSTOMIZE

  3.5     Starting the Group Servers
    3.5.1      Starting Group Servers from the DECmessageQ Main Menu
    3.5.2      Setting Up the Run-Time Environment with DMQ$STARTUP.COM

  3.6     Shutting Down a DECmessageQ COM Server
    3.6.1      Shutting Down a COM Server from the Main Menu
    3.6.2      Shutting Down a COM Server with DMQ$SHUTDOWN
    3.6.3      Shutting Down a COM Server with DMQ$MONITOR

  3.7     Connecting to Other Message Queuing Groups

  3.8     Connections from Other Message Queuing Groups

  3.9     Modifying the Group's Boot Command File

  3.10    Editing the Profile Section of DMQ$INIT.TXT

  3.11    Sharing Group Configuration Files

  3.12    Deleting a Message Queuing Group

  3.13    Starting Application Programs in a Message Queuing Group
    3.13.1     Attaching a Detached Process with DCL Context
      3.13.1.1     DMQ$DETACH_PROCESS.COM
    3.13.2     Attaching a Detached Process without DCL Context
      3.13.2.1     DMQ$COPY_LNM_TABLE.COM

  4      Configuring DECmessageQ Global Memory

  4.1     Message Queues
    4.1.1      Primary Queues
    4.1.2      Secondary Queues
    4.1.3      Multireader Queues
    4.1.4      Queue Configuration Table

  4.2     DECmessageQ Global Sections

  4.3     Buffer Pool Configuration Table

  5      Message Recovery Services (MRS)

  5.1     MRS Overview

  5.2     Configuring MRS

  5.3     DMQ$INIT.TXT Parameters for MRS

  5.4     Creating Destination Queue Files

  5.5     Storing the MRS Files

  5.6     MRS Internal Operation Tracing

  6      Selective Broadcast Services (SBS)

  6.1     Configuring SBS

  6.2     Configuring SBS for Basic Broadcasting

  6.3     Configuring SBS for Optimized Ethernet Mode

  7      Symbolic Naming Support

  7.1     Group Name Table

  7.2     Defining Type and Class Codes

  7.3     DNS Naming Support
    7.3.1      Required Setup for DNS
    7.3.2      Creating DNS Names
    7.3.3      Multiple Instances of DECmessageQ Names Supported by SUFFIX

  8      Monitoring and Troubleshooting a DECmessageQ System

  8.1     System Management Utilities
    8.1.1      DMQ$DNSLOAD
    8.1.2      DMQ$DQF_UTIL
    8.1.3      DMQ$DUMP_GNT
    8.1.4      DMQ$FORCEX
    8.1.5      DMQ$LIST_PROCS
    8.1.6      DMQ$LLS_VERIFY
    8.1.7      DMQ$LOADER
    8.1.8      DMQ$LOOP
    8.1.9      DMQ$MONITOR
    8.1.10     DMQ$QFLUSH
    8.1.11     DMQ$TEST

  8.2     Controlling DECmessageQ Console Logging
    8.2.1      DMQ$ERROUT
    8.2.2      DMQ$OPCOM_TARGET

  8.3     Troubleshooting in the DECmessageQ Environment
    8.3.1      Identifying the Problem Area
    8.3.2      Gathering More Information

  8.4     Basic Run-Time Troubleshooting Techniques

  9      Sizing and Tuning Your System

  9.1     Overview of the Sizing and Tuning Process
    9.1.1      Message Buffer Pool
    9.1.2      RCV_MSG_QUOTA_METHOD
    9.1.3      RCV_MSG_QUOTA
    9.1.4      Sizing the Buffer Pool and Queues
    9.1.5      Warning Levels

  9.2     DECmessageQ Internal Messages

  9.3     MRS System Requirements

  9.4     Sizing the Cross-Group Pool

  9.5     VMS Parameters
    9.5.1      VMS SYSGEN Parameters
      9.5.1.1      Global Sections
      9.5.1.2      Global Pages
      9.5.1.3      Global Page File
      9.5.1.4      Virtual Page Count
      9.5.1.5      Channel Count
    9.5.2      UAF Parameters
    9.5.3      NCP Parameters

  9.6     Large Message Buses

  10     DECmessageQ Security

  10.1    Access Control on Queues
    10.1.1     Securing the Reading of Permanent Queues
    10.1.2     Securing the Creation of Temporary Queues

  10.2    Setting the Global Section Protection Mask
    10.2.1     Protection Mask Logical Name
    10.2.2     Setting ACLs for Global Sections

  10.3    Controlling DECnet Access to the COM Server

  A   Directories and Logical Names

  A.1     Directories

  A.2     Logical Names

  B   Parameter Tuning Guidelines

  C   Special Management Topics

  C.1     Managing DECmessageQ on a VAXcluster

  C.2     Managing Failover

  C.3     Linking Updated Images

  D   Error Log Messages

  D.1     COM Server Error Log Messages

  D.2     MRS Error Log Messages

  D.3     SBS Error Log Messages

  Glossary

  EXAMPLES

  2-1        Invoking DMQ$CREATE_GROUP

  2-2        Invoking DMQ$STARTUP Without Starting the Servers

  2-3        Sample Edits to DMQ$INIT.TXT

  2-4        Starting the Servers from the Main Menu

  3-1        Starting the Servers from the Main Menu

  3-2        Sharing Configuration Files

  3-3        Temporary Command Procedure with LOGINOUT.EXE

  3-4        Accessing the Group Logical Name Table

  7-1        DMQ$TYPCLS.TXT

  7-2        DMQ$DNSLOAD.EXE

  8-1        Sample Output of DMQ$DUMP_GNT

  8-2        Sample Output of DMQ$FORCEX

  8-3        Sample Output of DMQ$LIST_PROCS

  8-4        Sample Output of the DMQ$LLS_VERIFY Utility

  8-5        Sample Output of the DMQ$LOOP Utility

  8-6        DECmessageQ MONITOR Process Screen

  8-7        DECmessageQ DMQ$MONITOR Cross-Group Screen

  8-8        DECmessageQ DMQ$MONITOR COM Server Information Screen

  8-9        Sample Output of the DMQ$QFLUSH Utility

  FIGURES

  1-1        Components of a DECmessageQ Message Queuing Group

  1-2        Global Memory

  2-1        DECmessageQ Main Menu

  3-1        Cross-Group Connection Table

  3-2        Profile Section

  4-1        Queue Configuration Table

  4-2        Buffer Pool Configuration Table

  5-1        MRS Server Initialization Section

  6-1        SBS Server Initialization Section

  7-1        Group Name Table (GNT)

  8-1        DECmessageQ DMQ$MONITOR Menu

  8-2        DECmessageQ Components in Troubleshooting

  8-3        DECmessageQ Startup Process Flow

  TABLES

  2-1        DMQ$INIT.TXT Sections

  3-1        Profile Parameters

  8-1        DMQ$DNSLOAD Commands

  8-2        Settings for DMQ$ERROUT

  8-3        Settings for DMQ$OPCOM_TARGET

  8-4        Troubleshooting Table

  10-1       Example Settings of DMQ$SET_GBLSEC_PROT

  10-2       DECmessageQ Global Section Names

  A-1        DECmessageQ Directories

  A-2        DECmessageQ Logical Names

  B-1        Parameter Tuning Guidelines