CONTENTS Title Page Copyright Page Preface Part I Configuring a DECmessageQ System 1 Overview of DECmessageQ 1.1 Understanding DECmessageQ 1.2 Planning a Distributed System 1.3 Configuring DECmessageQ-The Basics 1.3.1 Message Buses 1.3.2 Message Queues 1.3.3 Message Queuing Groups 1.4 Configuration Tasks 1.4.1 Defining the Message Queuing Environment 1.4.2 Creating Groups and Cross-Group Connections 1.4.3 Configuring Global Memory 1.4.4 Configuring Message Recovery 1.4.5 Setting Up Selective Broadcasting 1.4.6 Using Symbolic Names 2 Defining the Message Queuing Environment 2.1 Creating a DECmessageQ Manager Account 2.2 Creating a Message Queuing Group 2.2.1 Assigning a Bus ID 2.2.2 Executing DMQ$CREATE_GROUP 2.3 Setting Up the Run-Time Environment with DMQ$STARTUP.COM 2.4 Accessing the DECmessageQ Main Menu 2.5 Customizing Your DECmessageQ Configuration 2.5.1 Editing the DMQ$BOOT.COM File 2.5.2 Editing the DMQ$INIT.TXT File 2.5.3 Editing the DMQ$TYPCLS.TXT File 2.6 Starting the Group Servers 2.7 Shutting Down a DECmessageQ COM Server 2.7.1 Shutting Down a COM Server from the Main Menu 2.7.2 Shutting Down a COM Server with DMQ$SHUTDOWN.COM 2.7.3 Shutting Down a COM Server with DMQ$MONITOR 2.8 Setting Up the Logical Name Table 2.9 Defining VMS Symbols 3 Creating Groups and Cross-Group Connections 3.1 Configuring Message Queuing Groups 3.1.1 Creating Groups 3.1.2 Deleting Groups 3.1.3 Maintaining Group Configurations 3.2 Editing the Profile Section of DMQ$INIT.TXT 3.3 Connecting to Other Message Queuing Groups 3.3.1 Configuring the Cross-Group Connection Table 3.3.2 Configuring the Routing Table for Indirect Connections 3.3.3 Configuring DMQ$GMT_OFFSET for TCP/IP Network Communication 3.4 Sharing Group Configuration Files 3.5 Starting Application Programs in a Message Queuing Group 3.5.1 Attaching a Detached Process with DCL Context 3.5.2 Attaching a Detached Process without DCL Context 4 Configuring Global Memory 4.1 Types of Message Queues 4.2 Configuring Message Queues 4.3 Configuring Global Memory 5 Configuring Message Recovery 5.1 Configuring MRS 5.2 Setting Parameters for MRS 5.3 Creating Destination Queue Files 5.4 Storing the MRS Files 5.5 MRS Internal Operation Tracing 6 Setting Up Selective Broadcasting 6.1 Starting the SBS Server 6.2 Configuring Basic Broadcasting 6.3 Configuring Optimized Ethernet Mode 7 Using Symbolic Names 7.1 Configuring the 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 Part II Managing a DECmessageQ System 8 Using DECmessageQ Utilities 8.1 System Management Utility 8.1.1 Displaying Queue Summary Information 8.1.2 Displaying Queue Detail Information 8.1.3 Flushing Queues 8.1.4 Forcing a Process to Exit 8.1.5 Displaying the Group Name Table 8.2 MONITOR Utility 8.2.1 Displaying Queue Counters 8.2.2 Displaying Queue Quotas 8.2.3 Displaying COM Server Status 8.2.4 Displaying Queue Specific Status 8.2.5 Resetting COM Server Counters 8.2.6 Killing the COM Server Process 8.2.7 Displaying the Routing Table 8.2.8 Displaying Link Summary 8.2.9 Displaying Link Detail 8.2.10 Displaying the Link Connect Table 8.2.11 Displaying Group Detail 8.2.12 Sending Cross-Group Connections 8.2.13 Setting Alternate Groups 8.3 Configuration Utilities 8.3.1 Creating and Deleting DNS Names (DMQ$DNSLOAD) 8.3.2 Creating Destination Queue Files (DMQ$DQF_UTIL) 8.3.3 Verifying Buffer Pool Configuration (DMQ$LLS_VERIFY) 8.3.4 Adding Name String and Group Names (DMQ$LOADER) 8.4 Testing and Debugging Utilities 8.4.1 Testing DECmessageQ Communications (DMQ$LOOP) 8.4.2 Testing DECmessageQ Services (DMQ$TEST) 9 Troubleshooting a DECmessageQ System 9.1 Initialization Errors 9.2 Run-Time Errors 9.3 Gathering Information About the Error 9.4 Troubleshooting Run-Time Problems 9.5 Controlling DECmessageQ Console Logging 9.5.1 DMQ$ERROUT 9.5.2 DMQ$OPCOM_TARGET 10 Sizing and Tuning Your System 10.1 Overview of the Sizing and Tuning Process 10.1.1 Message Buffer Pool 10.1.2 rcv_msg_quota_method Parameter 10.1.3 rcv_msg_quota Parameter 10.1.4 Sizing the Buffer Pool and Queues 10.1.5 Warning Levels 10.2 DECmessageQ Internal Messages 10.3 MRS System Requirements 10.4 Sizing the Cross-Group Pool 10.5 VMS Parameters 10.5.1 VMS SYSGEN Parameters 10.5.1.1 Global Sections 10.5.1.2 Global Pages 10.5.1.3 Global Page File 10.5.1.4 Virtual Page Count 10.5.1.5 Channel Count 10.5.2 UAF Parameters 10.5.3 NCP Parameters 10.6 Large Message Buses 11 DECmessageQ Security 11.1 Defining Access Control on Queues 11.1.1 Securing the Reading of Permanent Queues 11.1.2 Securing the Creation of Temporary Queues 11.2 Setting the Global Section Protection Mask 11.2.1 Protection Mask Logical Name 11.2.2 Setting ACLs for Global Sections 11.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 Software on a VAXcluster Configuration C.2 Managing Failover C.3 Linking Updated Images D Error Log Messages D.1 COM Server and Link Driver Error Log Messages D.2 MRS Error Log Messages D.3 SBS Error Log Messages EXAMPLES 2-1 Invoking DMQ$CREATE_GROUP 2-2 Invoking DMQ$STARTUP Without Starting the Servers 2-3 Starting the Servers from the Main Menu 3-1 Profile Section 3-2 Sample Cross-Group Connections and Routing Tables 3-3 Sharing Configuration Files 3-4 Temporary Command Procedure with LOGINOUT.EXE 3-5 Accessing the Group Logical Name Table 3-6 Sample Output of DMQ$COPY_LNM_TABLE.COM 7-1 DMQ$TYPCLS.TXT 7-2 DMQ$DNSLOAD.EXE FIGURES 1-1 DECmessageQ Multivendor Support 1-2 Components of a DECmessageQ Message Queuing Group 2-1 DECmessageQ Main Menu 3-1 Cross-Group Connection Table 3-2 Sample System Routing Configuration 4-1 Queue Configuration Table 4-2 Buffer Pool Configuration Table 5-1 MRS Server Initialization Section 6-1 Multipoint Outbound Target Settings 6-2 SBS Server Initialization Section 7-1 Group Name Table (GNT) 8-1 Manager Utility Main Menu 8-2 Queue Summary 8-3 Queue Detail 8-4 Flush Queue 8-5 Sample Output of FORCEX Process Screen 8-6 Sample Output of Group Name Table Dump Screen 8-7 DECmessageQ MONITOR Utility Menu 8-8 DECmessageQ MONITOR Process Screen 8-9 Queue Quotas 8-10 DECmessageQ COM Server Specific Information Screen 8-11 Displaying Queue Specific Status 8-12 Routing Table Information 8-13 Displaying Link Summary Information 8-14 Display Link Detail 8-15 Display Link Connect Table 8-16 Display Group Detail 8-17 Set Alternal Group 8-18 Sample Output of the DMQ$LLS_VERIFY Utility 8-19 Sample Output of the DMQ$LOOP Utility 9-1 DECmessageQ Components in Troubleshooting 9-2 DECmessageQ Startup Process Flow TABLES 2-1 DMQ$STARTUP Parameters 2-2 DECmessageQ Main Menu Options 2-3 Sections in the DMQ$INIT.TXT File 3-1 Profile Parameters 3-2 Cross Group Table Section 3-3 GMT Offset 4-1 Queue Configuration Table 4-2 Buffer Pool Configuration Table 5-1 MRS Server Initialization Section 6-1 SBS Multipoint Outbound Target Settings 6-2 SBS Server Initialization Section 8-1 DMQ$DNSLOAD Commands 9-1 Troubleshooting Table 9-2 Settings for DMQ$ERROUT 9-3 Settings for DMQ$OPCOM_TARGET 10-1 Parameter Setting for Large Message Buses 11-1 Example Settings of DMQ$SET_GBLSEC_PROT 11-2 DECmessageQ Global Section Names A-1 DECmessageQ Directories A-2 DECmessageQ Logical Names B-1 Parameter Tuning Guidelines