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 RTR Version 2 and Version 3 Applications Coexist on the Same Node?
2.5	Process Quotas
2.6	Journal Issues
2.6.1	Removing the Old Journal
2.6.2	Journal Compatibility
2.6.3	Location and Naming Conventions
2.7	Rights and Privileges
2.8	Memory and Disk Requirements
2.9	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	OpenVMS Quotas
5.2	Startup
5.3	Creating Facilities
5.3.1	Naming Nodes
5.3.2	Modifying Facility Configurations
5.4	Interoperability
5.5	Monitoring
5.5.1	RTR Version 2 Screens
5.5.2	New Screens
5.5.3	User Parsing of Monitor Output
5.5.4	User Customized Monitors
5.5.5	History Screens
5.6	Remote Command Support
5.7	Partition Management
5.8	Transaction State Management
5.9	Using RTR Version 2 Command Procedures
5.10	Command Line Interface Support for RTR Version 2 API
5.11	Interpreting Output from SHOW Commands
5.12	Comparing RTR Version 2 and Version 3 Utility Commands
Chapter 6
6	Running Version 2 Applications
6.1	Comparison of OpenVMS API and Portable API
6.2	Recompiling and Relinking
6.2.1	RTR Version 2 Applications Running on RTR Version 3
6.3	Running Applications Installed with Privileges
6.3.1	Running Clients That Share Channels
6.4	Application Level Interoperability
6.5	Support for $GETTXI
6.6	Threaded Applications
6.7	DDTM Support
6.8	Current Issues
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	Simultaneous 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
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	New RTR Version 3 Monitor Pictures
5-4	Changed SHOW COMMANDS
5-5	Obsolete OpenVMS RTR Utility Commands
5-6	New OpenVMS RTR Utility Commands
6-1	OpenVMS API and Portable API Comparison
6-2	Application Interoperability