Reliable Transaction Router System Managers Manual
June
Contents
Transaction Management
RTR Monitoring
RTR Command Line Interface
100
103
104
105
Server Shadowing and Recovery
RTR Utility Error Messages RTR log messages Index Examples
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
Conventions Used in this Guide
Convention Meaning
Page
Entering Commands
Getting Started
Introduction Entering Commands
Online Help
Command Procedures
Remote Commands
Introduction Online Help
Rtralrsta
Introduction Remote Commands
Setting Up-An Example
Introduction
FrontendsFERoutersTRBackendsBE
Starting and Setting Up RTR Setting Up-An Example
Example 2-1 Local Configuration of each Node
Creating a Recovery Journal
Example 2-2 Remote Setup from one Node
Starting and Setting Up RTR Creating a Recovery Journal
Changing a Facility
Starting and Setting Up RTR Changing a Facility
Example 2-3 Reconfiguration Using Delete and Create Facility
O N T E N D S U T E R S
Setting up Callout Servers
Example 2-4 Reconfiguration Using Extend Facility
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
Starting and Setting Up RTR RTR Privileges
Setting RTR Privileges on OpenVMS Systems
Setting RTR Privileges on Windows NT Systems
RTR ACP Virtual Memory Sizing
Starting and Setting Up RTR RTR ACP Virtual Memory Sizing
Astlm Biolm Diolm Fillm Pgflquota
Unix Virtual Memory Sizing
Network Transports
Specifying the Link Transport Protocol
Using the Tunnel Prefix
Troubleshooting Tunnel and Wildcard Connections
TCP Services File
Anonymous Clients
Starting and Setting Up RTR Network Transports
Interoperation with RTR Version 2 Using DECnet
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
Show Partition command on each backend node is as follows
Router Backend a Backend B
SET Partition test/PRIORITYLIST=bronze,gold
Router Selection
Router Site a Node-A1 Site B Node-B1 Node-A2 Node-B2
RTR Create Facility test/FRONTEND=Z/ROUTER=A,B,C
What is Partition Management?
What is a Partition?
Overview
Partition Naming
Life Cycle of a Partition
Explicit Partition Creation
Binding Server Channels to Named Partitions
Persistence of Partition Definitions
Entering Partition Commands
Partition Management Entering Partition Commands
Command Line Usage
Programmed Partition Management
Command Line Example
Managing Partitions
Controlling Shadowing
Programming Information
Controlling Recovery
Example usage of the qualifiers
Partition Management Managing Partitions
Controlling the Active Site
Controlling Failover
Char
Controlling Transaction Replay
Rtruns32t newLimit
Displaying Partition Information
RTR$DEFAULTFACILITY
Partition Management Displaying Partition Information
Transaction Management
Transaction Management Overview
Command Line Examples
Exception Transactions
Transaction Management Overview Transaction State Changes
19 Valid Transaction State Transitions
4Transaction Management
RTR Monitoring
Standard Monitor Pictures
RTR Monitoring Standard Monitor Pictures
Standard Monitor Pictures
Cont Standard Monitor Pictures
Monitor Accfail Link Acceptance Failures
Dmark DEC.ZKO.DMARK
Monitor ACP2APP
RTR Monitoring Standard Monitor Pictures Monitor Active
Monitor APP2ACP
Monitor Broadcast
PID -ALL
RTR Monitoring Standard Monitor Pictures Monitor Calls
Monitor Channel
Monitor Connects
Calls
Monitor Event
Monitor Facility
Monitor Group
RTR Monitoring Standard Monitor Pictures Monitor Flow
Monitor Group Fields
Monitor Ipcrate
RTR Monitoring Standard Monitor Pictures Monitor IPC
Monitor Journal
Monitor Link
Monitor Netbytes
Monitor Partit
RTR Monitoring Standard Monitor Pictures Monitor Netstat
Monitor Partition States
Monitor Recovery
Nodea RTR$DEFAULTFACILITY
Monitor Queues
Monitor Quorum
Monitor Rejects
Monitor Recovery States
Monitor Rejects Fields
RTR Monitoring Standard Monitor Pictures Monitor Rejhist
Monitor Response
Process 38009A8B
Monitor Rejhist Fields
RTR Monitoring Standard Monitor Pictures Monitor Rolequorum
Monitor Routers
Monitor Routing
Quorum Counts by Facility 7-JAN-1999 143248, Node -ALL
RTR Monitoring Standard Monitor Pictures Monitor Rscbe
Monitor RTR
RTR Monitoring Standard Monitor Pictures Monitor Stalls
RTR Monitoring Standard Monitor Pictures Monitor System
Type Monitor Connects
RTR Monitoring Standard Monitor Pictures Monitor TPS
Monitor Traffic
Monitor Trans
Servers
Monitor XA
RTR Monitoring Standard Monitor Pictures Monitor V2CALLS
Monitor XA
Page
RTR Command Line Interface
RTR Command Reference
ADD Facility
Call Rtraccepttx
Format
Description
Call Rtraccepttx
CHANNELNAME=RTR$DEFAULTCHANNEL
Qualifiers
Forget Noforget
Independent Noindependent
Related Commands
Accept the current transaction with a reason
Call Rtrbroadcastevent
Parameters
Call Rtrbroadcastevent message-field1 ,message-field2
Message-field1 ,message-field2
CHANNELNAME=channel-name
Parameters for rtrbroadcastevent
EVENTNUMBER=user-event-number
Generated Format Strings
LENGTHOFFIELD=field-length
RECIPIENTSPEC=rcpspc
TYPEOFDATA=STRING Signed Unsigned /TYPEOFDATA=STRING D
Call Rtrbroadcastevent
Call Rtrclosechannel
Call Rtrclosechannel
Parameters for rtrclosechannel
Immediate IMMEDIATE=RTR$DEFAULTCHANNEL
This command closes the channel named ``client1
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
Parameters for rtropenchannel
Parameter Name Parameter Value Example
Client Noclient
Concurrent D Noconcurrent
FACILITY=RTR$DEFAULTFACILITY D
FACILITYNAME=facility-name
HIGHBOUND=high-bound HIGHBOUND=max-val-for-key-type D
KEYn=keysegdesc
LOWBOUND=low-bound LOWBOUND=min-val-for-key-type D
PARTITIONNAME=partition-name
Standby D Nostandby
Call Rtrclosechannel
Call Rtrpreparetx
Call Rtrpreparetx
Parameters for rtrpreparetx
DATA=data
DATA=0
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
Call Rtrreplytoclient message-field1 ,message-field2
11 Parameters for rtrreplytoclient
Accept Noaccept
12 Generated Format Strings
Following example replies a message to the client
Call Rtrrequestinfo
Call Rtrrequestinfo
13 Parameters for rtrrequestinfo
GETITM=item-name,item-name... No default
INFCLA=infoclass 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
14 Parameters for rtrsendtoserver
Expendable Noexpendable
15 Generated Format Strings
Readonly Noreadonly
Examples
Call Rtrstarttx
Call Rtrstarttx
16 Parameters for rtrstarttx
Nested Transaction Usage
JOINTXID=txid-number
Nojointxid
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
17 Platform Specific Information
Unix
Delete Journal Modify Journal Show Journal
Partitionname
Create Partition
Partitionname
Facility
Create Facility SET Partition
Define /KEY
Define /KEY key-name equivalence-string
Key-name
Key names
Equivalence-string
Echo D Noecho
RTR Define /KEY PF3 Show RTR /TERMINATE
RTR PF3
RTR Define /KEY PF1 Help /SETSTATE=GOLD /NOTERMINATE /ECHO
RTR Define /KEY PF1 Create /TERMINATE /IFSTATE=GOLD /ECHO
60RTR Command Line Interface
Delete Facility
Delete Facility facilityname
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
SEPARATE=keyword
Noseparate
Nototalize
TOTALIZE=keyword
=column
=previous-column D
Display Numeric
Display Numeric expression
DECIMALS=decimal-places /DECIMALS=0 D
KeywordMeaning
=column /X=previous-column D
76RTR Command Line Interface
Display String
Display String expression
78RTR Command Line Interface
WIDTH=field-width /WIDTH=0 D
80RTR Command Line Interface
Display Symbolic
Display Symbolic expression text-string ,text-string
82RTR Command Line Interface
Display Text text
Display Text
Text
Node Nonode
Related Commands
Do operating-system-command
DCL-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
Extend Facility facilityname
$ RTR RTR SET Environment /NODE=FE,FETRBE
BACKEND=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
OpenVMS Example
RTR Modify Journal DISK1$/BLOCKS=3000/MAXIMUMBLOCKS=20000
Monitor monitor-file-spec
Monitor
Monitor-file-spec
IDENTIFICATION=process-id
Noidentification D
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
Scroll direction amount
Direction
Amount
SET Environment
SET Environment
Cluster
NODE=node-list
SET Facility
SET Facility facility-name
Balance Nobalance
RTR SET Facility FINANCE/QUORUMTHRESHOLD=4
RTR SET Facility FINANCE/BALANCE
SET Link
SET Link link-name
Enable Disable
Suspect Nosuspect
RTR SET Link JOEY/ENABLE
RTR SET Link JOEY/AUTOISOLATE
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/GROUP
RTR SET MODE/NOGROUP
SET Node
SET node
RTR SET Node /NOISOLATE
SET Partition partition-name
SET Partition
Partition-name
RECOVERYRETRYCOUNT=n
Restartrecovery
PRIORITYLIST=backend-node-list
Resume
Timeout
Suspend
SET Transaction
SET Transaction transaction-id
Facility FACILITY=RTR$DEFAULTFACILITY D
Usage Notes
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$DEFAULTCHANNEL
RTR Show CHANNEL/ALLWINDOWS
Clichn
CLICHN2
Show Client
Show Client
Full none D
TEST43
RTR Show CLIENT/FULL
CLI
Show Display
Show Display
=column /Y=row
RTR MON Calls RTR Show DISPLAY/ALL
Display Numeric
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
RTR Show FACILITY/FULL/NODE=BRONZE
Link to Airola Frontend Yes Router Backend
RTR Show FACILITY/BALANCE
Show Journal
Show Journal
Create Journal Delete Journal Initialize Journal
Show KEY
Show KEY key-name
RTR Show KEY/FULL
Show Link node-name
Show Link
Node-name
Full
RTR Show LINK/FULL Iron
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/ROUTER/FULL
RTR Show PARTITION/BACKEND
Show Partition
Show Process
Show Process
Processes Process-id Process Name
Show Requester
Show Resource Manager Show RM
Show RM resourcename
Rmid
Show RTR
Show RTR
Status D Nostatus
RTR Show RTR
Show Segment
Show Segment
RTR$DEFAULTFACILITY Unsigned Testfac Signed
Show Server
Show Server
22 Key-range States
Server Flags
RTR Show Server
SRV
RTR Show SERVER/FULL
Lowerserv
Show Transaction
Show Transaction
24 Transaction Invocation Types
25 Key-Range States
Key-Range States
RTR Show TRANSACTION/BACKEND/FULL
Receiving
Original
Spawn operating-system-command
Operating-system-command
Spawn
Noutput
Start RTR
Start RTR
ASTLM=ast-limit
BIOLM=io-buffered
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
Trim Facility facilityname
RTR RTR SET Environment /NODE=FE,FETRBE,NFE
FRONTEND=frontend-list
Nofrontend D
Unregister Resource Manager Unregister RM
Creating Monitor Pictures
Table A-1 Information Classes
Interactive Definition of a Monitor Picture
Example A-1 Interactive Picture Definition
Substitution Symbols
Table A-2 Substitution symbols
Arithmetic Expressions and Operators
Test Picture AT Some Data Item Other Data Item
Table A-3 Arithmetic Operators in Display Commands
Example A-2 Arithmetic Operators Examples
Aggregation of Data Items
Some output has been omitted for clarity
Page
Primary and Secondary Roles
Automatic Features
Shadow Events
Server Shadowing and Recovery Automatic Features
RTR Journal System
Server Shadowing and Recovery RTR Journal System
Shadow Site Failure and Journaling
Standby for Shadows
Performance
Shadows in Action
Server Shadowing and Recovery Performance
Application Considerations
Server States
Server Shadowing and Recovery Application Considerations
CHAN2
Server Shadowing and Recovery Server States
Figure B-2 Server States
Server Shadowing and Recovery Client States
Client States
Requester State Transitions
CHAN3
Server Shadowing and Recovery Partition States
Partition States
Page
New Qualifier to Create Facility Command
XA Support
Microsoft DTC Support
XA Support Introduction
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