PARTITIONNAME=partition-name | Compaq AA-Q88CE-TE instruction

CALL RTR_OPEN_CHANNEL

/OFFSET_OF_KEY=offset /OFFSET_OF_KEY=0 (D)

Speciﬁes the offset of the key within the messages in bytes. The default is zero, that is, the key is at the start of the messages.

Note that only one key segment deﬁnition is allowed.

/OUTPUT[=ﬁle-spec] /OUTPUT=stdout (D)

Speciﬁes that the resulting information is written to the ﬁle file-spec. If /OUTPUT or file-specis omitted then the standard or default output is used.

/PARTITION_NAME=partition-name

Enables a system manager to specify a particular named partition.

/PREPARE_EXPLICIT /NOPREPARE_EXPLICIT

Speciﬁes that the ﬂag RTR_F_OPE_EXPLICIT_PREPARE is set in the call to rtr_open_channel( ).

/RECIPIENT_NAME=rcpnam /RECIPIENT_NAME=null (D)

Speciﬁes an optional name for broadcast reception to be associated with the channel. Only broadcasts matching this name are delivered on the channel. (Note that to receive named events, the correct event number must also be speciﬁed.)

RECIPIENT_NAME is case sensitive. If /RECIPIENT_NAME is supplied without a qualiﬁer value, then its value defaults to the value of /CHANNEL_NAME. Not supplying the /RECIPIENT_NAME qualiﬁer has the same effect as specifying a null string. Wild card characters cannot be used for this qualiﬁer. (Senders of broadcasts can use wildcards when specifying /RECIPIENT_SPEC).

/SERVER /NOSERVER (D)

Speciﬁes that the RTR_F_OPE_SERVER ﬂag is set in the call to

rtr_open_channel( ). Use this qualiﬁer if you want to declare the channel as a server.

/SHADOW /NOSHADOW (D)

The /SHADOW qualiﬁer speciﬁes that the RTR_F_OPE_SHADOW ﬂag is set in the call to rtr_open_channel( ). The server is part of a shadow pair.

/STANDBY (D)

/NOSTANDBY

The /NOSTANDBY qualiﬁer speciﬁes that the ﬂag RTR_F_OPE_NOSTANDBY is set in the call to rtr_open_channel( ), and the server may not be (or have) standby(s). By default, servers may have standby(s).

/TR_CALL_OUT /NOTR_CALL_OUT (D)

Speciﬁes that the RTR_F_OPE_TR_CALL_OUT ﬂag is set in the call to

rtr_open_channel( ), and the server is a router call-out server. By default a server is not a router call-out server.

6–20RTR Command Line Interface

Image 96

Compaq AA-Q88CE-TE manual PARTITIONNAME=partition-name, Standby D Nostandby

Contents

Reliable Transaction Router System Managers Manual June Contents Transaction Management RTR Monitoring RTR Command Line Interface 100 103104 105 Server Shadowing and Recovery RTR Utility Error Messages RTR log messages Index ExamplesCreating Monitor Pictures XA Support Tables Arithmetic Operators in Display Commands Page Purpose of this Manual Intended AudienceStructure of Document Related Documentation Readers CommentsConventions Conventions Used in this Guide Convention MeaningPage Entering Commands Getting Started Introduction Entering Commands Online Help Command Procedures Remote CommandsIntroduction Online Help Rtralrsta Introduction Remote Commands Setting Up-An Example Introduction Starting and Setting Up RTR Setting Up-An Example FrontendsFERoutersTRBackendsBEExample 2-1 Local Conﬁguration 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 Reconﬁguration Using Delete and Create Facility O N T E N D S U T E R S Setting up Callout Servers Example 2-4 Reconﬁguration Using Extend Facility Starting and Setting Up RTR 2.5 Setting up Callout Servers Router Load BalancingExample 2-5 Conﬁguration of Callout Servers Starting and Setting Up RTR Router Load Balancing Setting RTR Privileges on Unix SystemsRTR Privileges Starting and Setting Up RTR RTR Privileges Setting RTR Privileges on OpenVMS SystemsSetting 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 Preﬁx Troubleshooting Tunnel and Wildcard ConnectionsTCP Services File Anonymous Clients Starting and Setting Up RTR Network Transports Interoperation with RTR Version 2 Using DECnet Running RTR as a Service on Windows NT Network Protocol Selection on OpenVMS$ DEFINE/SYSTEM Rtrprefprot Rtrdnafirst Files Created by the RTR Windows NT Service How RTR Selects Processing-states Roles for Nodes Role Assignment for Backend Node PartitionsActive 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 a Partition? What is Partition Management?Overview Partition Naming Life Cycle of a Partition Binding Server Channels to Named Partitions Explicit Partition CreationPersistence of Partition Deﬁnitions Entering Partition Commands Partition Management Entering Partition CommandsCommand Line Usage Programmed Partition Management Command Line Example Managing PartitionsControlling Shadowing Programming Information Controlling Recovery Example usage of the qualiﬁers Partition Management Managing Partitions Controlling the Active Site Controlling Failover Char Controlling Transaction Replay Rtruns32t newLimit RTR$DEFAULTFACILITY Displaying Partition InformationPartition Management Displaying Partition Information Transaction Management Command Line Examples Transaction Management OverviewException 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 APP2ACPMonitor Broadcast PID -ALL RTR Monitoring Standard Monitor Pictures Monitor Calls Monitor ChannelMonitor Connects Calls Monitor Event Monitor Facility RTR Monitoring Standard Monitor Pictures Monitor Flow Monitor GroupMonitor Group Fields RTR Monitoring Standard Monitor Pictures Monitor IPC Monitor IpcrateMonitor Journal Monitor Link Monitor Netbytes RTR Monitoring Standard Monitor Pictures Monitor Netstat Monitor PartitMonitor Partition States Monitor Recovery Nodea RTR$DEFAULTFACILITYMonitor Queues Monitor Quorum Monitor Recovery States Monitor RejectsMonitor Rejects Fields RTR Monitoring Standard Monitor Pictures Monitor Rejhist Monitor ResponseProcess 38009A8B Monitor Rejhist Fields RTR Monitoring Standard Monitor Pictures Monitor Rolequorum Monitor RoutersMonitor 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 TrafﬁcMonitor Trans Servers RTR Monitoring Standard Monitor Pictures Monitor V2CALLS Monitor XAMonitor XA Page RTR Command Line Interface RTR Command Reference ADD Facility Call Rtraccepttx FormatDescription Call Rtraccepttx CHANNELNAME=RTR$DEFAULTCHANNEL QualiﬁersForget Noforget Independent Noindependent Related Commands Accept the current transaction with a reason Call Rtrbroadcastevent ParametersCall Rtrbroadcastevent message-ﬁeld1 ,message-ﬁeld2 Message-ﬁeld1 ,message-ﬁeld2 Parameters for rtrbroadcastevent CHANNELNAME=channel-nameEVENTNUMBER=user-event-number Generated Format Strings LENGTHOFFIELD=ﬁeld-lengthRECIPIENTSPEC=rcpspc TYPEOFDATA=STRING Signed Unsigned /TYPEOFDATA=STRING D Call Rtrbroadcastevent Call Rtrclosechannel Call RtrclosechannelParameters for rtrclosechannel Immediate IMMEDIATE=RTR$DEFAULTCHANNEL This command closes the channel named ``client1 Call Rtrerrortext Call RtrerrortextParameters for rtrerrortext STATUS=status-code No default Call Rtrgettid Call RtrgettidParameters 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-nameHIGHBOUND=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 RtrpreparetxParameters for rtrpreparetx DATA=data DATA=0 Prepare the current transaction with a reason Call Rtrreceivemessage Call RtrreceivemessageParameters for rtrreceivemessage 26RTR Command Line Interface Msgsb msgtype msglen usrhdl 0 tid Call Rtrrejecttx Call Rtrrejecttx10 Parameters for rtrrejecttx Call Rtropenchannel Call Rtraccepttx Reject the current transaction with a reason Call Rtrreplytoclient Call Rtrreplytoclient message-ﬁeld1 ,message-ﬁeld2 11 Parameters for rtrreplytoclient Accept Noaccept 12 Generated Format Strings Following example replies a message to the client Call Rtrrequestinfo Call Rtrrequestinfo13 Parameters for rtrrequestinfo GETITM=item-name,item-name... No default INFCLA=infoclass No defaultSELITM=item-name No default SELVAL=item-value No default RTR Call RTRRECEIVEMESSAGE/CHANNEL=INFOCHAN/TIMEOUT Call Rtrsendtoserver Call Rtrsendtoserver message-ﬁeld1 ,message-ﬁeld2Message-ﬁeld ,message-ﬁeld2 14 Parameters for rtrsendtoserver Expendable Noexpendable 15 Generated Format Strings Readonly Noreadonly Examples Call Rtrstarttx Call Rtrstarttx16 Parameters for rtrstarttx Nested Transaction Usage JOINTXID=txid-number NojointxidTxidtype Ddtm Call Rtrrejecttx Call Rtraccepttx Clear Clear=column =row 46RTR Command Line Interface Create Facility Create Facility facilitynameFacilityname Default for role-list is ROUTER,BACKEND RESOURCEMANAGER=resource-list 50RTR Command Line Interface Create Journal Create Journal disk-1 ... ,disk-nDisk-1, ... disk-n 17 Platform Speciﬁc Information Unix Delete Journal Modify Journal Show Journal Create Partition PartitionnamePartitionname Facility Create Facility SET Partition Define /KEY Define /KEY key-name equivalence-stringKey-name Key names Equivalence-string Echo D Noecho RTR Define /KEY PF3 Show RTR /TERMINATE RTR PF3RTR 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 Display BAR expressionExpression AVERAGE=keyword NoaverageCHARACTER=char SEPARATE=keyword Noseparate TOTALIZE=keyword Nototalize=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=ﬁeld-width /WIDTH=0 D 80RTR Command Line Interface Display Symbolic Display Symbolic expression text-string ,text-string 82RTR Command Line Interface Display Text Display Text textText Node Nonode Related Commands Do operating-system-command DCL-command Example RTR DO/CLUSTER Show TimeRTR DO/NODE=TR2,TR1 Show Logical Mylogical Flush Namecache Flush Namecache Execute Execute ﬁle-specﬁle-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 Modify Journal disk-1 ... ,disk-nDisk-1 ... disk-n OpenVMS Example RTR Modify Journal DISK1$/BLOCKS=3000/MAXIMUMBLOCKS=20000 Monitor Monitor monitor-ﬁle-specMonitor-ﬁle-spec IDENTIFICATION=process-id Noidentification D RTR Monitor TRAFFIC/COUNT=10/OUTPUT=PICTURE.LIS Quit Quit Recall command-speciﬁer Command-speciﬁerRecall Register Resource Manager Register RM ResourcenameResourcename 106RTR Command Line Interface Scroll Scroll direction amountDirection Amount SET Environment SET EnvironmentCluster 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/FILE=RTRLOG.LOG/OPERATOR RTR SET LOG/NOFILE/NOOPERATORRTR SET LOG/OPERATOR SET Mode SET ModeGROUP=user-id Nogroup RTR SET MODE/GROUP RTR SET MODE/NOGROUP SET Node SET node RTR SET Node /NOISOLATE SET Partition SET Partition partition-namePartition-name RECOVERYRETRYCOUNT=n RestartrecoveryPRIORITYLIST=backend-node-list Resume Timeout Suspend SET Transaction SET Transaction transaction-id Facility FACILITY=RTR$DEFAULTFACILITY D Usage NotesTransaction-id BEFORE=date Newstate 19 Valid Transaction State ChangesSINCE=date RTR SET Transaction /NEW=ABORT /CURRENT=VOTED /PART=DBPART Show Channel Show Channel channel-nameChannel-name RTR$DEFAULTCHANNEL RTR Show CHANNEL/ALLWINDOWSClichn CLICHN2 Show Client Show ClientFull none D RTR Show CLIENT/FULL TEST43CLI Show Display Show Display=column /Y=row RTR MON Calls RTR Show DISPLAY/ALL Display NumericBlank WIDTH=9 Show Environment Show EnvironmentRTR SET ENVIRONMENT/NODE=FE2,FE3 RTR Show Environment Show Facility Show Facility facility-nameFacility-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 Show Link node-nameNode-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 Partition20 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 Server22 Key-range States Server Flags RTR Show Server SRVRTR Show SERVER/FULL Lowerserv Show Transaction Show Transaction24 Transaction Invocation Types 25 Key-Range States Key-Range States RTR Show TRANSACTION/BACKEND/FULLReceiving Original Spawn operating-system-command Operating-system-commandSpawn 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 RTRAbort 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 Deﬁnition of a Monitor Picture Example A-1 Interactive Picture Deﬁnition Substitution Symbols Table A-2 Substitution symbolsArithmetic 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 clarityPage Automatic Features Primary and Secondary RolesShadow 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 Server Shadowing and Recovery Performance Shadows in ActionApplication Considerations Server Shadowing and Recovery Application Considerations Server StatesCHAN2 Server Shadowing and Recovery Server States Figure B-2 Server States Server Shadowing and Recovery Client States Client StatesRequester State Transitions CHAN3 Server Shadowing and Recovery Partition States Partition StatesPage New Qualiﬁer to Create Facility Command XA Support Microsoft DTC Support XA Support IntroductionModiﬁed 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