Reliable Transaction Router System Managers Manual
June
Contents
RTR Monitoring
Transaction Management
RTR Command Line Interface
103
100
104
105
RTR Utility Error Messages RTR log messages Index Examples
Server Shadowing and Recovery
Creating Monitor Pictures
XA Support
Tables
Arithmetic Operators in Display Commands
Page
Intended Audience
Purpose of this Manual
Structure of Document
Readers Comments
Related Documentation
Conventions
Convention Meaning
Conventions Used in this Guide
Page
Getting Started
Entering Commands
Online Help
Introduction Entering Commands
Remote Commands
Command Procedures
Introduction Online Help
Rtralrsta
Introduction Remote Commands
Introduction
Setting Up-An Example
FrontendsFERoutersTRBackendsBE
Starting and Setting Up RTR Setting Up-An Example
Example 2-1 Local Configuration of each Node
Example 2-2 Remote Setup from one Node
Creating a Recovery Journal
Changing a Facility
Starting and Setting Up RTR Creating a Recovery Journal
Example 2-3 Reconfiguration Using Delete and Create Facility
Starting and Setting Up RTR Changing a Facility
O N T E N D S U T E R S
Example 2-4 Reconfiguration Using Extend Facility
Setting up Callout Servers
Router Load Balancing
Starting and Setting Up RTR 2.5 Setting up Callout Servers
Example 2-5 Configuration of Callout Servers
Setting RTR Privileges on Unix Systems
Starting and Setting Up RTR Router Load Balancing
RTR Privileges
Setting RTR Privileges on OpenVMS Systems
Starting and Setting Up RTR RTR Privileges
Setting RTR Privileges on Windows NT Systems
RTR ACP Virtual Memory Sizing
Astlm Biolm Diolm Fillm Pgflquota
Starting and Setting Up RTR RTR ACP Virtual Memory Sizing
Unix Virtual Memory Sizing
Specifying the Link Transport Protocol
Network Transports
Troubleshooting Tunnel and Wildcard Connections
Using the Tunnel Prefix
TCP Services File
Anonymous Clients
Interoperation with RTR Version 2 Using DECnet
Starting and Setting Up RTR Network Transports
Network Protocol Selection on OpenVMS
Running RTR as a Service on Windows NT
$ DEFINE/SYSTEM Rtrprefprot Rtrdnafirst
Files Created by the RTR Windows NT Service
Role Assignment for Backend Node Partitions
How RTR Selects Processing-states Roles for Nodes
Active
Router Backend a Backend B
Show Partition command on each backend node is as follows
SET Partition test/PRIORITYLIST=bronze,gold
Router Site a Node-A1 Site B Node-B1 Node-A2 Node-B2
Router Selection
RTR Create Facility test/FRONTEND=Z/ROUTER=A,B,C
What is Partition Management?
What is a Partition?
Overview
Life Cycle of a Partition
Partition Naming
Explicit Partition Creation
Binding Server Channels to Named Partitions
Persistence of Partition Definitions
Partition Management Entering Partition Commands
Entering Partition Commands
Command Line Usage
Programmed Partition Management
Managing Partitions
Command Line Example
Controlling Shadowing
Programming Information
Example usage of the qualifiers
Controlling Recovery
Controlling the Active Site
Partition Management Managing Partitions
Char
Controlling Failover
Rtruns32t newLimit
Controlling Transaction Replay
Displaying Partition Information
RTR$DEFAULTFACILITY
Partition Management Displaying Partition Information
Transaction Management
Transaction Management Overview
Command Line Examples
Exception Transactions
19 Valid Transaction State Transitions
Transaction Management Overview Transaction State Changes
4Transaction Management
Standard Monitor Pictures
RTR Monitoring
Standard Monitor Pictures
RTR Monitoring Standard Monitor Pictures
Cont Standard Monitor Pictures
Dmark DEC.ZKO.DMARK
Monitor Accfail Link Acceptance Failures
Monitor ACP2APP
Monitor APP2ACP
RTR Monitoring Standard Monitor Pictures Monitor Active
Monitor Broadcast
PID -ALL
Monitor Channel
RTR Monitoring Standard Monitor Pictures Monitor Calls
Monitor Connects
Calls
Monitor Facility
Monitor Event
Monitor Group
RTR Monitoring Standard Monitor Pictures Monitor Flow
Monitor Group Fields
Monitor Ipcrate
RTR Monitoring Standard Monitor Pictures Monitor IPC
Monitor Journal
Monitor Netbytes
Monitor Link
Monitor Partit
RTR Monitoring Standard Monitor Pictures Monitor Netstat
Monitor Partition States
Nodea RTR$DEFAULTFACILITY
Monitor Recovery
Monitor Queues
Monitor Quorum
Monitor Rejects
Monitor Recovery States
Monitor Rejects Fields
Monitor Response
RTR Monitoring Standard Monitor Pictures Monitor Rejhist
Process 38009A8B
Monitor Rejhist Fields
Monitor Routers
RTR Monitoring Standard Monitor Pictures Monitor Rolequorum
Monitor Routing
Quorum Counts by Facility 7-JAN-1999 143248, Node -ALL
Monitor RTR
RTR Monitoring Standard Monitor Pictures Monitor Rscbe
RTR Monitoring Standard Monitor Pictures Monitor Stalls
Type Monitor Connects
RTR Monitoring Standard Monitor Pictures Monitor System
Monitor Traffic
RTR Monitoring Standard Monitor Pictures Monitor TPS
Monitor Trans
Servers
Monitor XA
RTR Monitoring Standard Monitor Pictures Monitor V2CALLS
Monitor XA
Page
RTR Command Reference
RTR Command Line Interface
ADD Facility
Format
Call Rtraccepttx
Description
Call Rtraccepttx
Qualifiers
CHANNELNAME=RTR$DEFAULTCHANNEL
Forget Noforget
Independent Noindependent
Accept the current transaction with a reason
Related Commands
Parameters
Call Rtrbroadcastevent
Call Rtrbroadcastevent message-field1 ,message-field2
Message-field1 ,message-field2
CHANNELNAME=channel-name
Parameters for rtrbroadcastevent
EVENTNUMBER=user-event-number
LENGTHOFFIELD=field-length
Generated Format Strings
RECIPIENTSPEC=rcpspc
TYPEOFDATA=STRING Signed Unsigned /TYPEOFDATA=STRING D
Call Rtrbroadcastevent
Call Rtrclosechannel
Call Rtrclosechannel
Parameters for rtrclosechannel
This command closes the channel named ``client1
Immediate IMMEDIATE=RTR$DEFAULTCHANNEL
Call Rtrerrortext
Call Rtrerrortext
Parameters for rtrerrortext
STATUS=status-code No default
Call Rtrgettid
Call Rtrgettid
Parameters for rtrgettid
Tid e100b810,0,0,0,0,3bc5,6eb02001
Call Rtropenchannel
Call Rtropenchannel
Parameter Name Parameter Value Example
Parameters for rtropenchannel
Concurrent D Noconcurrent
Client Noclient
FACILITYNAME=facility-name
FACILITY=RTR$DEFAULTFACILITY D
HIGHBOUND=high-bound HIGHBOUND=max-val-for-key-type D
KEYn=keysegdesc
LOWBOUND=low-bound LOWBOUND=min-val-for-key-type D
Standby D Nostandby
PARTITIONNAME=partition-name
Call Rtrclosechannel
Call Rtrpreparetx
Call Rtrpreparetx
Parameters for rtrpreparetx
DATA=0
DATA=data
Prepare the current transaction with a reason
Call Rtrreceivemessage
Call Rtrreceivemessage
Parameters for rtrreceivemessage
26RTR Command Line Interface
Msgsb msgtype msglen usrhdl 0 tid
Call Rtrrejecttx
Call Rtrrejecttx
10 Parameters for rtrrejecttx
Call Rtropenchannel Call Rtraccepttx
Reject the current transaction with a reason
Call Rtrreplytoclient message-field1 ,message-field2
Call Rtrreplytoclient
Accept Noaccept
11 Parameters for rtrreplytoclient
12 Generated Format Strings
Following example replies a message to the client
Call Rtrrequestinfo
Call Rtrrequestinfo
13 Parameters for rtrrequestinfo
INFCLA=infoclass No default
GETITM=item-name,item-name... No default
SELITM=item-name No default
SELVAL=item-value No default
RTR Call RTRRECEIVEMESSAGE/CHANNEL=INFOCHAN/TIMEOUT
Call Rtrsendtoserver message-field1 ,message-field2
Call Rtrsendtoserver
Message-field ,message-field2
Expendable Noexpendable
14 Parameters for rtrsendtoserver
Readonly Noreadonly
15 Generated Format Strings
Examples
Call Rtrstarttx
Call Rtrstarttx
16 Parameters for rtrstarttx
Nested Transaction Usage
Nojointxid
JOINTXID=txid-number
Txidtype
Ddtm
Call Rtrrejecttx Call Rtraccepttx
Clear
Clear
=column =row
46RTR Command Line Interface
Create Facility facilityname
Create Facility
Facilityname
Default for role-list is ROUTER,BACKEND
RESOURCEMANAGER=resource-list
50RTR Command Line Interface
Create Journal disk-1 ... ,disk-n
Create Journal
Disk-1, ... disk-n
Unix
17 Platform Specific Information
Delete Journal Modify Journal Show Journal
Partitionname
Create Partition
Partitionname
Facility
Create Facility SET Partition
Define /KEY key-name equivalence-string
Define /KEY
Key-name
Key names
Echo D Noecho
Equivalence-string
RTR PF3
RTR Define /KEY PF3 Show RTR /TERMINATE
RTR Define /KEY PF1 Help /SETSTATE=GOLD /NOTERMINATE /ECHO
RTR Define /KEY PF1 Create /TERMINATE /IFSTATE=GOLD /ECHO
60RTR Command Line Interface
Delete Facility facilityname
Delete Facility
Create Facility Show Facility
Delete Journal
Delete Journal
64RTR Command Line Interface
Delete Partition
Create Partition Show Partition
Display BAR expression
Display BAR
Expression
Noaverage
AVERAGE=keyword
CHARACTER=char
Noseparate
SEPARATE=keyword
Nototalize
TOTALIZE=keyword
=column
=previous-column D
Display Numeric expression
Display Numeric
DECIMALS=decimal-places /DECIMALS=0 D
KeywordMeaning
=column /X=previous-column D
76RTR Command Line Interface
Display String expression
Display String
78RTR Command Line Interface
WIDTH=field-width /WIDTH=0 D
80RTR Command Line Interface
Display Symbolic expression text-string ,text-string
Display Symbolic
82RTR Command Line Interface
Display Text text
Display Text
Text
Node Nonode
Related Commands
DCL-command
Do operating-system-command
RTR DO/CLUSTER Show Time
Example
RTR DO/NODE=TR2,TR1 Show Logical Mylogical
Flush Namecache
Flush Namecache
Execute file-spec
Execute
file-spec
Exit
Exit
Extend Facility facilityname
Extend Facility
BACKEND=FETRBE
$ RTR RTR SET Environment /NODE=FE,FETRBE
$ RTR
ROUTER=FETRBE
Default for role-list is ROUTER,BACKEND
Create Facility Delete Facility Show Facility Trim Facility
Initialize Journal
LOG
LOG
RTR LOG/OUTPUT=RTRLOG.LOG Message check here
Modify Journal disk-1 ... ,disk-n
Modify Journal
Disk-1 ... disk-n
RTR Modify Journal DISK1$/BLOCKS=3000/MAXIMUMBLOCKS=20000
OpenVMS Example
Monitor monitor-file-spec
Monitor
Monitor-file-spec
Noidentification D
IDENTIFICATION=process-id
RTR Monitor TRAFFIC/COUNT=10/OUTPUT=PICTURE.LIS
Quit
Quit
Command-specifier
Recall command-specifier
Recall
Resourcename
Register Resource Manager Register RM
Resourcename
106RTR Command Line Interface
Scroll direction amount
Scroll
Direction
Amount
SET Environment
SET Environment
Cluster
NODE=node-list
SET Facility facility-name
SET Facility
Balance Nobalance
RTR SET Facility FINANCE/BALANCE
RTR SET Facility FINANCE/QUORUMTHRESHOLD=4
SET Link link-name
SET Link
Enable Disable
Suspect Nosuspect
RTR SET Link JOEY/AUTOISOLATE
RTR SET Link JOEY/ENABLE
SET LOG
SET LOG
RTR SET LOG/NOFILE/NOOPERATOR
RTR SET LOG/FILE=RTRLOG.LOG/OPERATOR
RTR SET LOG/OPERATOR
SET Mode
SET Mode
GROUP=user-id
Nogroup
RTR SET MODE/NOGROUP
RTR SET MODE/GROUP
SET node
SET Node
RTR SET Node /NOISOLATE
SET Partition partition-name
SET Partition
Partition-name
Restartrecovery
RECOVERYRETRYCOUNT=n
PRIORITYLIST=backend-node-list
Resume
Suspend
Timeout
SET Transaction transaction-id
SET Transaction
Usage Notes
Facility FACILITY=RTR$DEFAULTFACILITY D
Transaction-id
BEFORE=date
19 Valid Transaction State Changes
Newstate
SINCE=date
RTR SET Transaction /NEW=ABORT /CURRENT=VOTED /PART=DBPART
Show Channel channel-name
Show Channel
Channel-name
RTR Show CHANNEL/ALLWINDOWS
RTR$DEFAULTCHANNEL
Clichn
CLICHN2
Show Client
Show Client
Full none D
TEST43
RTR Show CLIENT/FULL
CLI
Show Display
Show Display
=column /Y=row
Display Numeric
RTR MON Calls RTR Show DISPLAY/ALL
Blank
WIDTH=9
Show Environment
Show Environment
RTR SET ENVIRONMENT/NODE=FE2,FE3 RTR Show Environment
Show Facility facility-name
Show Facility
Facility-name
State Nostated
Link to Airola Frontend Yes Router Backend
RTR Show FACILITY/FULL/NODE=BRONZE
RTR Show FACILITY/BALANCE
Show Journal
Show Journal
Create Journal Delete Journal Initialize Journal
Show KEY key-name
Show KEY
RTR Show KEY/FULL
Show Link node-name
Show Link
Node-name
RTR Show LINK/FULL Iron
Full
Show LOG
Show LOG
RTR Show LOG
Show Mode
Show Mode
RTR Show Mode
Show Node
Show Node
RTR Show Node
Show Partition
Show Partition
20 Key-Range States
21 Router Partition States
RTR Show PARTITION/BACKEND
RTR Show PARTITION/ROUTER/FULL
Show Partition
Show Process
Show Process
Processes Process-id Process Name
Show Requester
Show RM resourcename
Show Resource Manager Show RM
Rmid
Show RTR
Show RTR
RTR Show RTR
Status D Nostatus
Show Segment
Show Segment
RTR$DEFAULTFACILITY Unsigned Testfac Signed
Show Server
Show Server
22 Key-range States
Server Flags
SRV
RTR Show Server
RTR Show SERVER/FULL
Lowerserv
Show Transaction
Show Transaction
24 Transaction Invocation Types
25 Key-Range States
RTR Show TRANSACTION/BACKEND/FULL
Key-Range States
Receiving
Original
Operating-system-command
Spawn operating-system-command
Spawn
Noutput
Start RTR
Start RTR
BIOLM=io-buffered
ASTLM=ast-limit
174RTR Command Line Interface
PRCLM=subprocess-limit /PRCLM=10 D
Show RTR Stop RTR
Stop RTR
Stop RTR
Abort
Show RTR Start RTR
Trim Facility facilityname
Trim Facility
FRONTEND=frontend-list
RTR RTR SET Environment /NODE=FE,FETRBE,NFE
Nofrontend D
Unregister Resource Manager Unregister RM
Table A-1 Information Classes
Creating Monitor Pictures
Example A-1 Interactive Picture Definition
Interactive Definition of a Monitor Picture
Table A-2 Substitution symbols
Substitution Symbols
Arithmetic Expressions and Operators
Test Picture AT Some Data Item Other Data Item
Example A-2 Arithmetic Operators Examples
Table A-3 Arithmetic Operators in Display Commands
Some output has been omitted for clarity
Aggregation of Data Items
Page
Primary and Secondary Roles
Automatic Features
Shadow Events
RTR Journal System
Server Shadowing and Recovery Automatic Features
Shadow Site Failure and Journaling
Server Shadowing and Recovery RTR Journal System
Performance
Standby for Shadows
Shadows in Action
Server Shadowing and Recovery Performance
Application Considerations
Server States
Server Shadowing and Recovery Application Considerations
CHAN2
Figure B-2 Server States
Server Shadowing and Recovery Server States
Client States
Server Shadowing and Recovery Client States
Requester State Transitions
CHAN3
Partition States
Server Shadowing and Recovery Partition States
Page
XA Support
New Qualifier to Create Facility Command
XA Support Introduction
Microsoft DTC Support
Modified RTR API
RTR Open Channel
RTR Utility Error Messages
RTR Utility Error Messages
RTR Utility Error Messages D-3
4RTR Utility Error Messages
RTR Utility Error Messages D-5
6RTR Utility Error Messages
RTR Utility Error Messages D-7
8RTR Utility Error Messages
RTR Utility Error Messages D-9
Explanation
RTR Utility Error Messages D-11
12RTR Utility Error Messages
RTR Utility Error Messages D-13
Blocks
RTR Utility Error Messages D-15
16RTR Utility Error Messages
RTR Utility Error Messages D-17
18RTR Utility Error Messages
RTR Utility Error Messages D-19
20RTR Utility Error Messages
RTR Utility Error Messages D-21
22RTR Utility Error Messages
RTR-S-RTRLOGENT, a
24RTR Utility Error Messages
RTR Utility Error Messages D-25
26RTR Utility Error Messages
RTR log messages
2RTR log messages
RTR log messages E-3
4RTR log messages
RTR-I-FACSTOPPED, Facility a stopped on local node
6RTR log messages
RTR-I-LOGFILENT, a a a
8RTR log messages
RTR log messages E-9
10RTR log messages
RTR log messages E-11
12RTR log messages
RTR log messages E-13
Page
Index
Index-2
Index-3
Index-4