Reliable Transaction Router
Migration Guide

Contents

Preface
Preface	Preface
Chapter 1
1	Introduction
1.1	Why Migrate?
1.2	Goals and Nongoals
1.3	Reading Guidelines
Chapter 2
2	Installation
2.1	Cleaning Up the Old Version 2 Environment
2.2	Preserving the Old Environment
2.3	Can Both RTR Version 2 and Version 3 Coexist On the Same Node?
2.4	Can Both RTR Version 2 and Version 4 Coexist on the Same Node?
2.5	Can Mixed Version Applications Coexist on the Same Node?
2.6	Process Quotas
2.7	Journal Issues
2.7.1	Removing the Old Journal
2.7.2	Journal Compatibility
2.7.3	Location and Naming Conventions
2.8	Rights and Privileges
2.9	Memory and Disk Requirements
2.10	Rollback to RTR Version 2
Chapter 3
3	Architectural Changes
3.1	RTR Daemon Process
3.2	Command Server Process
3.3	The Shared Library (LIBRTR.EXE)
3.4	The ACP Process
3.5	Interprocess Communication
3.6	Shared Memory Parameters
3.7	Counters
3.8	Quorum Issues
3.9	Server-Process Partition States
Chapter 4
4	Network Issues
4.1	DECnet Support
4.2	TCP/IP Support
4.3	Specifying a Preferred Transport
4.3.1	Supported Products
Chapter 5
5	System Management
5.1	RTR Management Station
5.1.1	Browser Interface
5.2	OpenVMS Quotas
5.3	Startup
5.4	Creating Facilities
5.4.1	Naming Nodes
5.4.2	Modifying Facility Configurations
5.5	Interoperability
5.6	Monitoring
5.6.1	RTR Version 2 Screens
5.6.2	New Screens
5.6.3	User Parsing of Monitor Output
5.6.4	User-Customized Monitors
5.6.5	History Screens
5.7	Remote Command Support
5.8	Partition Management
5.9	Transaction State Management
5.10	Using RTR Version 2 Command Procedures
5.11	Command Line Interface Support for RTR Version 2 API
5.12	Interpreting Output from SHOW Commands
5.13	Comparing RTR Version 2 and Version 3 or 4 Utility Commands
Chapter 6
6	Running Version 2 Applications
6.1	Comparison of OpenVMS API and C Programming API
6.2	Recompiling and Relinking
6.2.1	RTR Version 2 Applications Running on RTR Version 3 or 4
6.3	Running Applications Installed with Privileges
6.3.1	Running Clients That Share Channels
6.4	Application Level Interoperability
6.5	Support for $GET_TXI
6.6	Threaded Applications
6.7	DDTM Support
6.8	Use of $DEQ_TX Calls
6.9	C++ API
Chapter 7
7	Performance Tips
7.1	Process Quotas
7.2	Journal Sizing
7.3	RTR Startup Qualifiers
7.4	Monitoring
7.5	Memory
7.6	Symmetric Multiprocessing
Chapter 8
8	Problem Diagnosis and Reporting
8.1	RTR Operator Log
8.2	RTR_ERROR.LOG File
8.3	Dump File
8.4	Producing and Directing a Trace
8.5	Dealing with a Looping Process
8.6	Contents of the RTR Journal File
Index
Index
Figures
1	Reading Path
Tables
2-1	OpenVMS Limits
2-2	OpenVMS Disk Requirements
3-1	RTR Executables
5-1	Interoperability Between Nodes
5-2	Obsolete RTR Version 2 Monitor Pictures
5-3	Standard Monitor Pictures
5-4	Changed SHOW COMMANDS
5-5	Obsolete OpenVMS RTR Utility Commands
5-6	New OpenVMS RTR Utility Commands
5-7	RTR Utility Commands New with RTR Version 4
5-8	New Qualifiers to RTR DISPLAY Commands
5-9	New Qualifier to RTR SET NODE Command
6-1	OpenVMS API and C Programming API Comparison
6-2	Application Interoperability