Compaq AAR-88LB-TE manual Preface, Audience, Organization of This Guide

Page 7

Preface

This guide explains how to migrate a Reliable Transaction Router (RTR) environment and RTR applications from RTR Version 2 to RTR Version 3. It assumes that the application continues to use the RTR Version 2 application programming interface (API) without change. It also provides information on new and obsolete features.

Audience

This guide is written for RTR system managers.

The system manager should be familiar with the following aspects of the OpenVMS operating system:

•DIGITAL Command Language (DCL)

•A text editor, such as EDT or EVE

The system manager should also be familiar with:

•Monitoring RTR performance

•Adjusting RTR performance

•Installation of RTR Version 2

•Making changes to the RTR environment

•Application use of the RTR Version 2 Application Programming Interface (API)

•Applications running on RTR

Organization of This Guide

The following list can help you ﬁnd information in this guide:

Chapter 1	Provides an introduction to the migration guide and summarizes new
	and changed features.
Chapter 2	Describes changes to the installation procedure.
Chapter 3	Describes how the RTR architecture has changed.
Chapter 4	Describes changes to the network conﬁguration that supports RTR.
Chapter 5	Describes changes important to the system manager.
Chapter 6	Describes changes to the RTR API.
Chapter 7	Describes performance and application tips.
Chapter 8	Describes problem diagnosis and reporting.

vii

Image 7

Contents Compaq Computer Corporation Houston, Texas Reliable Transaction Router Migration GuideJune Operating SystemFirst Printing, December Revised, June Preface ContentsInstallation Network IssuesPerformance Tips 8 Problem Diagnosis and ReportingSystem Management 6 Running Version 2 ApplicationsIndex Tables Page Audience PrefaceOrganization of This Guide Readers Comments Related DocumentsConventions monospace Page Introduction 1.1 Why Migrate?1.2 Goals and Nongoals Introduction 1.1 Why Migrate?1.3 Reading Guidelines 2.1 Cleaning Up the Old Version 2 Environment Installation2.5 Process Quotas Installation 2.2 Preserving the Old Environment2.2 Preserving the Old Environment 2.3 Can Both RTR Version 2 and Version 3 Coexist On the Same Node?Installation 2.5 Process Quotas 2.6 Journal IssuesTable 2-1 OpenVMS Limits 2.6.2 Journal Compatibility Installation 2.6 Journal Issues 2.6.1 Removing the Old Journal2.7 Rights and Privileges 2.8 Memory and Disk RequirementsTable 2-2 OpenVMS Disk Requirements 2.9 Rollback to RTR Version2.8 Memory and Disk Requirements DEASSIGN/SYSTEM/EXEC RTRSHRPage 3.3 The Shared Library LIBRTR.EXE 3.2 Command Server ProcessArchitectural Changes 3.1 RTR Daemon Process3.7 Counters 3.4 The ACP Process3.5 Interprocess Communication 3.6 Shared Memory ParametersArchitectural Changes 3.8 Quorum Issues 3.8 Quorum Issues3.9 Server-Process Partition States Page 4.1 DECnet Support Network Issues4.2 TCP/IP Support 4.3 Specifying a Preferred Transport Network Issues 4.3 Specifying a Preferred Transport4.3.1 Supported Products 5.3 Creating Facilities System Management5.1 OpenVMS Quotas 5.2 Startup5.5.1 RTR Version 2 Screens 5.4 Interoperability5.5 Monitoring System Management 5.4 InteroperabilityTable 5-3 New RTR Version 3 Monitor Pictures 5.5 Monitoring5.5.3 User Parsing of Monitor Output 5.5.4 User Customized Monitors5.11 Interpreting Output from SHOW Commands 5.6 Remote Command Support5.9 Using RTR Version 2 Command Procedures 5.10 Command Line Interface Support for RTR Version 2 APITable 5-5 Obsolete OpenVMS RTR Utility Commands 5.12 Comparing RTR Version 2 and Version 3 Utility CommandsSystem Management 5.11 Interpreting Output from SHOW Commands Table 5-4 Cont. Changed SHOW COMMANDSTable 5-6 Cont. New OpenVMS RTR Utility Commands 5.12 Comparing RTR Version 2 and Version 3 Utility Commands6.1 Comparison of OpenVMS API and Portable API Running Version 2 ApplicationsTable 6-1 OpenVMS API and Portable API Comparison 6.2 Recompiling and RelinkingRunning Version 2 Applications 6.1 Comparison of OpenVMS API and Portable API6.2.1 RTR Version 2 Applications Running on RTR Version Running Version 2 Applications 6.2 Recompiling and Relinking6.5 Support for $GETTXI 6.3 Running Applications Installed with Privileges6.3 Running Applications Installed with Privileges 6.4 Application Level InteroperabilityRunning Version 2 Applications 6.6 Threaded Applications 6.8 Current Issues6.6 Threaded Applications 6.7 DDTM SupportPage 7.3 RTR Startup Qualiﬁers Performance Tips7.1 Process Quotas 7.2 Journal SizingPerformance Tips 7.6 Simultaneous Multiprocessing 7.6 Simultaneous Multiprocessing8.3 Dump File Problem Diagnosis and Reporting8.2 RTRERROR.LOG File 8.1 RTR Operator Log4. Enter the OpenVMS ANALYZE/SYSTEM SET PROCESS RTRACP command 8.6 Contents of the RTR Journal FileProblem Diagnosis and Reporting 8.4 Producing and Directing a Trace 1. Enter the SHOW PROCESS RTRACP/CONTINUOUS OpenVMS commandIndex