Compaq AAR-88LB-TE User manual

ReliableTransactionRouter

MigrationGuide

Order Number: AA–R88LB–TE

June 1999

This guide explains how to migrate from Reliable Transaction Router™

(RTR) Version 2 to RTR Version 3 on OpenVMS™ systems, and provides

information on new and obsolete features.

Revision/Update Information: This guide supersedes the Reliable

Transaction Router Migration Guide

for Version 3.1D.

Operating System: OpenVMS Versions 6.2, 7.1, 7.2

Software Version: Reliable Transaction Router Version

3.2

Compaq Computer Corporation

Houston, Texas

First Printing, December 1997

Revised, June 1999

COMPAQ COMPUTER CORPORATION SHALL NOT BE LIABLE FOR TECHNICAL

OR EDI‘ ERRORS OR OMISSIONS CONTAINED HEREIN, NOR FOR INCIDENTAL OR

CONSEQUENTIAL DAMAGES RESULTING FROM THE FURNISHING, PERFORMANCE,

OR USE OF THIS MATERIAL. THIS INFORMATION IS PROVIDED "AS IS" AND

COMPAQ COMPUTER CORPORATION DISCLAIMS ANY WARRANTIES, EXPRESS,

IMPLIED OR STATUTORY AND EXPRESSLY DISCLAIMS THE IMPLIED WARRANTIES

OF MERCHANTABILITY, FITNESS FOR PARTICULAR PURPOSE, GOOD TITLE AND

AGAINST INFRINGEMENT.

This publication contains information protected by copyright. No part of this publication

may be photocopied or reproduced in any form without prior written consent from

Compaq Computer Corporation.

The software described in this guide is furnished under a license agreement or nondisclosue

agreement. The software may be used or copied only in accordance with the terms of the

agreement.

Compaq and the Compaq logo are registered in the United States Patent and Trademark Ofﬁce.

The following are trademarks of Compaq Computer Corporation: AlphaGeneration, AlphaServer,

AlphaStation, DEC, DECconnect, DECdtm, DECevent, DECsafe, DECnet, DECwindows, DIGITAL,

DIGITAL UNIX, LAT, OpenVMS, PATHWORKS, POLYCENTER, TruCluster, Reliable Transaction

Router, VAX, and VMScluster.

The following are third-party trademarks:

AIX and IBM are registered trademarks of International Business Machines Corporation.

Memory Channel is a trademark of Encore Computer Corporation.

Hewlett-Packard and HP-UX are registered trademarks of Hewlett-Packard Company.

Microsoft is a registered trademark, and Windows 95 and Windows NT are trademarks of Microsoft

Corporation.

Oracle is a registered trademark of Oracle Corporation.

Solaris and SUN are registered trademarks of Sun Microsystems, Inc.

POSIX is a registered trademark of the Institute of Electrical and Electronics Engineers.

PostScript is a registered trademark of Adobe Systems, Inc.

UNIX is a registered trademark licensed exclusively through X/Open Company Ltd.

X Window System is a trademark of Massachusetts Institute of Technology.

All other trademarks and registered trademarks are the property of their respective holders.

This document was prepared using VAX DOCUMENT Version 2.1.

Contents

Preface ............................................................ vii

1 Introduction

1.1 Why Migrate?............................................... 1–1

1.2 Goals and Nongoals . . ........................................ 1–2

1.3 Reading Guidelines . . ........................................ 1–2

2 Installation

2.1 Cleaning Up the Old Version 2 Environment ....................... 2–1

2.2 Preserving the Old Environment ................................ 2–2

2.3 Can Both RTR Version 2 and Version 3 Coexist On the Same Node? ..... 2–2

2.4 Can RTR Version 2 and Version 3 Applications Coexist on the Same

Node? ..................................................... 2–2

2.5 Process Quotas .............................................. 2–2

2.6 Journal Issues .............................................. 2–3

2.6.1 Removing the Old Journal . . ................................ 2–4

2.6.2 Journal Compatibility ..................................... 2–4

2.6.3 Location and Naming Conventions ........................... 2–4

2.7 Rights and Privileges . ........................................ 2–4

2.8 Memory and Disk Requirements ................................ 2–4

2.9 Rollback to RTR Version 2 ..................................... 2–5

3 Architectural Changes

3.1 RTR Daemon Process . ........................................ 3–1

3.2 Command Server Process ...................................... 3–1

3.3 The Shared Library (LIBRTR.EXE) .............................. 3–1

3.4 The ACP Process ............................................ 3–2

3.5 Interprocess Communication . . . ................................ 3–2

3.6 Shared Memory Parameters . . . ................................ 3–2

3.7 Counters . . ................................................ 3–2

3.8 Quorum Issues .............................................. 3–3

3.9 Server-Process Partition States . ................................ 3–3

4 Network Issues

4.1 DECnet Support............................................. 4–1

4.2 TCP/IP Support ............................................. 4–1

4.3 Specifying a Preferred Transport ................................ 4–2

4.3.1 Supported Products ....................................... 4–2

iii

5 System Management

5.1 OpenVMS Quotas............................................ 5–1

5.2 Startup.................................................... 5–1

5.3 Creating Facilities . . . ........................................ 5–1

5.3.1 Naming Nodes . . . ........................................ 5–1

5.3.2 Modifying Facility Conﬁgurations ............................ 5–1

5.4 Interoperability ............................................. 5–2

5.5 Monitoring . ................................................ 5–2

5.5.1 RTR Version 2 Screens ..................................... 5–2

5.5.2 New Screens ............................................ 5–2

5.5.3 User Parsing of Monitor Output ............................. 5–3

5.5.4 User Customized Monitors . . ................................ 5–3

5.5.5 History Screens . . ........................................ 5–4

5.6 Remote Command Support .................................... 5–4

5.7 Partition Management ........................................ 5–4

5.8 Transaction State Management . ................................ 5–4

5.9 Using RTR Version 2 Command Procedures ....................... 5–4

5.10 Command Line Interface Support for RTR Version 2 API ............. 5–4

5.11 Interpreting Output from SHOW Commands....................... 5–4

5.12 Comparing RTR Version 2 and Version 3 Utility Commands ........... 5–5

6 Running Version 2 Applications

6.1 Comparison of OpenVMS API and Portable API .................... 6–1

6.2 Recompiling and Relinking .................................... 6–2

6.2.1 RTR Version 2 Applications Running on RTR Version 3 ........... 6–3

6.3 Running Applications Installed with Privileges ..................... 6–4

6.3.1 Running Clients That Share Channels . ....................... 6–4

6.4 Application Level Interoperability ............................... 6–4

6.5 Support for $GETTXI. ........................................ 6–4

6.6 Threaded Applications ........................................ 6–5

6.7 DDTM Support ............................................. 6–5

6.8 Current Issues .............................................. 6–5

7 Performance Tips

7.1 Process Quotas .............................................. 7–1

7.2 Journal Sizing .............................................. 7–1

7.3 RTR Startup Qualiﬁers ....................................... 7–1

7.4 Monitoring . ................................................ 7–1

7.5 Memory . . . ................................................ 7–1

7.6 Simultaneous Multiprocessing . . ................................ 7–2

8 Problem Diagnosis and Reporting

8.1 RTR Operator Log . . . ........................................ 8–1

8.2 RTR_ERROR.LOG File ....................................... 8–1

8.3 Dump File . ................................................ 8–1

8.4 Producing and Directing a Trace ................................ 8–1

8.5 Dealing with a Looping Process . ................................ 8–2

8.6 Contents of the RTR Journal File ............................... 8–2

Index

Tables

2–1 OpenVMS Limits . ........................................ 2–3

2–2 OpenVMS Disk Requirements ............................... 2–5

3–1 RTR Executables . ........................................ 3–1

5–1 Interoperability Between Nodes .............................. 5–2

5–2 Obsolete RTR Version 2 Monitor Pictures ...................... 5–2

5–3 New RTR Version 3 Monitor Pictures . . ....................... 5–3

5–4 Changed SHOW COMMANDS ............................... 5–4

5–5 Obsolete OpenVMS RTR Utility Commands .................... 5–5

5–6 New OpenVMS RTR Utility Commands. ....................... 5–5

6–1 OpenVMS API and Portable API Comparison ................... 6–2

6–2 Application Interoperability . ................................ 6–4

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

Related Documents

The following documents provide more information about topics discussed in this

guide:

Document Title Description

Reliable Transaction Router

Installation Guide Describes how to install Reliable Transaction Router.

Reliable Transaction Router

System Manager’s Manual Describes how to conﬁgure, manage, and monitor

Reliable Transaction Router

Application Programmer’s

Reference Manual

Describes how to code RTR applications, and contains

full descriptions of RTR API calls.

Reliable Transaction Router

Application Design Guide Describes how to design applications that use RTR.

Reliable Transaction Router

Release Notes Describes new features, changes, and known

restrictions for Reliable Transaction Router on all

supported platforms.

The following document is your best source for information on OpenVMS

procedures that you should be familiar with when using this migration guide:

Document Title Description

OpenVMS System Manager’s

Manual: Essentials Part one of a task-oriented guide to managing an

OpenVMS system.

The following document is a useful source for writing applications on OpenVMS:

Document Title Description

DEC C Run-Time Library

Reference Manual for OpenVMS Describes use of the DEC C run-time library.

Reader’s Comments

Compaq welcomes your comments on this guide. Please send us your comments

by email to [email protected]. Include the title of the manual, date on the title

page, section and page numbers with your comments or suggestions.

Conventions

The following conventions are used in this document.

Convention Meaning

Ctrl/X While you hold down the Ctrl key, press another key or a pointing

device button.

Italic Indicates parameters whose values you must provide. For example,

if the procedure asks you to type ﬁle name, you must type the actual

name of a ﬁle.

Italic also indicates variables and the titles of referenced documents.

viii

Convention Meaning

monospace

Indicates the actual commands, words, or characters that you type

in a dialog box, at a command prompt, or system output.

Note: Provides information of special importance.

/ A forward slash in command descriptions indicates that a command

qualiﬁer follows.

. . . A horizontal ellipsis following an entry in a command line indicates

that the entry or a similar entry can be repeated any number of

times. An ellipsis following a ﬁle name indicates that additional

parameters, values, or information can be entered.

A vertical ellipsis in an example indicates that not all the data are

shown.

This manual suits for next models

Table of contents

Other Compaq Software manuals

Compaq

Compaq 234664-002 - ProLiant - ML330T02 User manual

Compaq

Compaq 230039-001 - StorageWorks NAS Executor E7000 Model 904... Supplement

Compaq

Compaq BL10e - HP ProLiant - 512 MB RAM Technical manual

Compaq

Compaq BL10e - HP ProLiant - 512 MB RAM Technical manual

Compaq

Compaq 239158-999 - Mini Tower - Power Supply 250... Instruction Manual

Compaq

Compaq TP Desktop Connector AA-PVNFG-TE User manual

Compaq

Compaq t5300 - Thin Client Service manual

Compaq

Compaq dc5750 - Microtower PC User manual

Compaq

Compaq BL10e - HP ProLiant - 512 MB RAM Technical manual

Compaq

Compaq Presario SR1400 - Desktop PC User manual

Compaq

Compaq Tru64 UNIX User manual

Compaq

Compaq dc7800 - Convertible Minitower PC User manual

Compaq

Compaq BL10e - HP ProLiant - 512 MB RAM Technical manual

Compaq

Compaq DEC Text Processing Utility (DECTPU) Guide User manual

Compaq

Compaq COBOL AAQ2G1FTK User manual

Compaq

Compaq Aero 8000 Manual

Compaq

Compaq Proliant 800 User manual

Compaq

Compaq Compaq TCP/IP Services for OpenVMS Owner's manual

Compaq

Compaq AA-Q88CE-TE User guide

Compaq

Compaq Armada 6500 Mounting instructions

Compaq

Compaq BL10e - HP ProLiant - 512 MB RAM Technical manual

Compaq

Compaq dc5800 - Microtower PC User manual

Compaq

Compaq SANworksNetwork User manual

Compaq

Compaq Aero 8000 Manual

Popular Software manuals by other brands

COMPRO

COMPRO COMPROFM manual

Muratec

Muratec OFFICEBRIDGE ONLINE user guide

Oracle

Oracle Contact Center Anywhere 8.1 installation guide

Adobe

Adobe 65007312 - Photoshop Lightroom Programmer's guide

Avaya

Avaya NULL One-X for RIM Blackberry user guide

HP ProLiant BL420c user guide

PS Audio

PS Audio PowerPlay Programming manual

Brady

Brady LOCKOUT PRO 3.0 Administrator's guide

Avaya

Avaya Interaction Center user guide

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Guide book

Novell

Novell GROUPWISE 8 - INTERNET AGENT manual

Oracle

Oracle Application 9i Configuration guide

Acer

Acer RDM user guide

Canon

Canon Vixia HF21 instruction manual

Canon

Canon ZR950 instruction manual

Samsung

Samsung Auto Backup user manual

Polycom

Polycom Vortex EF2201 Application note

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c user manual