Manuals / Compaq / Computer Equipment / Network Router

Compaq AA-Q88CE-TE manual Call Rtrrejecttx Call Rtraccepttx

Models: AA-Q88CE-TE

1 320

Download 320 pages 38.47 Kb

Page 120

CALL RTR_START_TX

/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.

/TIMEOUT_MS=timoutms /TIMEOUT_MS=0 (D)

The timoutms argument deﬁnes a timeout for the transaction, in milliseconds. The default value is an inﬁnite timeout. /TIMEOUT_MS speciﬁes an immediate timeout (timeout if no message to receive).

/TXID_TYPE=txid-type /TXID_TYPE=RTR (D)

Possible values for TXID_TYPE parameter are RTR, DDTM and XA.

Related commands

•CALL RTR_REJECT_TX

•CALL RTR_ACCEPT_TX

Examples

This command starts a new transaction with a timout of 5000 milliseconds.

RTR> CALL RTR_START_TX /TIMEOUT_MS=5000 %RTR-S-OK, Normal successful completion

6–44RTR Command Line Interface

Image 120

Compaq AA-Q88CE-TE manual Call Rtrrejecttx Call Rtraccepttx

Contents

Reliable Transaction Router System Managers Manual June Contents Transaction Management RTR MonitoringRTR Command Line Interface 100 103104 105Server Shadowing and Recovery RTR Utility Error Messages RTR log messages Index ExamplesCreating Monitor Pictures XA SupportTables 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 StartedIntroduction Entering Commands Online HelpCommand Procedures Remote CommandsIntroduction Online Help RtralrstaIntroduction Remote Commands Setting Up-An Example IntroductionStarting 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 NodeStarting and Setting Up RTR Creating a Recovery Journal Changing a FacilityStarting and Setting Up RTR Changing a Facility Example 2-3 Reconﬁguration Using Delete and Create FacilityO N T E N D S U T E R S Setting up Callout Servers Example 2-4 Reconﬁguration Using Extend FacilityStarting 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 SizingStarting and Setting Up RTR RTR ACP Virtual Memory Sizing Astlm Biolm Diolm Fillm PgflquotaUnix Virtual Memory Sizing Network Transports Specifying the Link Transport ProtocolUsing the Tunnel Preﬁx Troubleshooting Tunnel and Wildcard ConnectionsTCP Services File Anonymous ClientsStarting and Setting Up RTR Network Transports Interoperation with RTR Version 2 Using DECnetRunning 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 BSET Partition test/PRIORITYLIST=bronze,gold Router Selection Router Site a Node-A1 Site B Node-B1 Node-A2 Node-B2RTR Create Facility test/FRONTEND=Z/ROUTER=A,B,C What is a Partition? What is Partition Management?Overview Partition Naming Life Cycle of a PartitionBinding Server Channels to Named Partitions Explicit Partition CreationPersistence of Partition Deﬁnitions Entering Partition Commands Partition Management Entering Partition CommandsCommand Line Usage Programmed Partition ManagementCommand Line Example Managing PartitionsControlling Shadowing Programming InformationControlling Recovery Example usage of the qualiﬁersPartition Management Managing Partitions Controlling the Active SiteControlling Failover CharControlling Transaction Replay Rtruns32t newLimitRTR$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 Transitions4Transaction Management RTR Monitoring Standard Monitor PicturesRTR Monitoring Standard Monitor Pictures Standard Monitor PicturesCont Standard Monitor Pictures Monitor Accfail Link Acceptance Failures Dmark DEC.ZKO.DMARKMonitor ACP2APP RTR Monitoring Standard Monitor Pictures Monitor Active Monitor APP2ACPMonitor Broadcast PID -ALLRTR Monitoring Standard Monitor Pictures Monitor Calls Monitor ChannelMonitor Connects CallsMonitor Event Monitor FacilityRTR Monitoring Standard Monitor Pictures Monitor Flow Monitor GroupMonitor Group Fields RTR Monitoring Standard Monitor Pictures Monitor IPC Monitor IpcrateMonitor Journal Monitor Link Monitor NetbytesRTR Monitoring Standard Monitor Pictures Monitor Netstat Monitor PartitMonitor Partition States Monitor Recovery Nodea RTR$DEFAULTFACILITYMonitor Queues Monitor QuorumMonitor Recovery States Monitor RejectsMonitor Rejects Fields RTR Monitoring Standard Monitor Pictures Monitor Rejhist Monitor ResponseProcess 38009A8B Monitor Rejhist FieldsRTR Monitoring Standard Monitor Pictures Monitor Rolequorum Monitor RoutersMonitor Routing Quorum Counts by Facility 7-JAN-1999 143248, Node -ALLRTR Monitoring Standard Monitor Pictures Monitor Rscbe Monitor RTRRTR Monitoring Standard Monitor Pictures Monitor Stalls RTR Monitoring Standard Monitor Pictures Monitor System Type Monitor ConnectsRTR Monitoring Standard Monitor Pictures Monitor TPS Monitor TrafﬁcMonitor Trans ServersRTR Monitoring Standard Monitor Pictures Monitor V2CALLS Monitor XAMonitor XA Page RTR Command Line Interface RTR Command ReferenceADD Facility Call Rtraccepttx FormatDescription Call RtraccepttxCHANNELNAME=RTR$DEFAULTCHANNEL QualiﬁersForget Noforget Independent NoindependentRelated Commands Accept the current transaction with a reasonCall Rtrbroadcastevent ParametersCall Rtrbroadcastevent message-ﬁeld1 ,message-ﬁeld2 Message-ﬁeld1 ,message-ﬁeld2Parameters for rtrbroadcastevent CHANNELNAME=channel-nameEVENTNUMBER=user-event-number Generated Format Strings LENGTHOFFIELD=ﬁeld-lengthRECIPIENTSPEC=rcpspc TYPEOFDATA=STRING Signed Unsigned /TYPEOFDATA=STRING DCall Rtrbroadcastevent Call Rtrclosechannel Call RtrclosechannelParameters for rtrclosechannel Immediate IMMEDIATE=RTR$DEFAULTCHANNEL This command closes the channel named ``client1Call Rtrerrortext Call RtrerrortextParameters for rtrerrortext STATUS=status-code No defaultCall Rtrgettid Call RtrgettidParameters for rtrgettid Tid e100b810,0,0,0,0,3bc5,6eb02001 Call Rtropenchannel Call RtropenchannelParameters for rtropenchannel Parameter Name Parameter Value ExampleClient Noclient Concurrent D NoconcurrentFACILITY=RTR$DEFAULTFACILITY D FACILITYNAME=facility-nameHIGHBOUND=high-bound HIGHBOUND=max-val-for-key-type D KEYn=keysegdescLOWBOUND=low-bound LOWBOUND=min-val-for-key-type D PARTITIONNAME=partition-name Standby D NostandbyCall Rtrclosechannel Call Rtrpreparetx Call RtrpreparetxParameters for rtrpreparetx DATA=data DATA=0Prepare 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-ﬁeld211 Parameters for rtrreplytoclient Accept Noaccept12 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 defaultRTR Call RTRRECEIVEMESSAGE/CHANNEL=INFOCHAN/TIMEOUT Call Rtrsendtoserver Call Rtrsendtoserver message-ﬁeld1 ,message-ﬁeld2Message-ﬁeld ,message-ﬁeld2 14 Parameters for rtrsendtoserver Expendable Noexpendable15 Generated Format Strings Readonly NoreadonlyExamples Call Rtrstarttx Call Rtrstarttx16 Parameters for rtrstarttx Nested Transaction UsageJOINTXID=txid-number NojointxidTxidtype DdtmCall 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 UnixDelete Journal Modify Journal Show Journal Create Partition PartitionnamePartitionname Facility Create Facility SET Partition Define /KEY Define /KEY key-name equivalence-stringKey-name Key namesEquivalence-string Echo D NoechoRTR Define /KEY PF3 Show RTR /TERMINATE RTR PF3RTR Define /KEY PF1 Help /SETSTATE=GOLD /NOTERMINATE /ECHO RTR Define /KEY PF1 Create /TERMINATE /IFSTATE=GOLD /ECHO60RTR Command Line Interface Delete Facility Delete Facility facilitynameCreate Facility Show Facility Delete Journal Delete Journal64RTR Command Line Interface Delete Partition Create Partition Show Partition Display BAR Display BAR expressionExpression AVERAGE=keyword NoaverageCHARACTER=char SEPARATE=keyword NoseparateTOTALIZE=keyword Nototalize=column =previous-column D Display Numeric Display Numeric expressionDECIMALS=decimal-places /DECIMALS=0 D KeywordMeaning =column /X=previous-column D 76RTR Command Line Interface Display String Display String expression78RTR Command Line Interface WIDTH=ﬁeld-width /WIDTH=0 D 80RTR Command Line Interface Display Symbolic Display Symbolic expression text-string ,text-string82RTR Command Line Interface Display Text Display Text textText Node Nonode Related Commands Do operating-system-command DCL-commandExample RTR DO/CLUSTER Show TimeRTR DO/NODE=TR2,TR1 Show Logical Mylogical Flush Namecache Flush NamecacheExecute Execute ﬁle-specﬁle-spec Exit ExitExtend Facility Extend Facility facilityname$ RTR RTR SET Environment /NODE=FE,FETRBE BACKEND=FETRBE$ RTR ROUTER=FETRBEDefault for role-list is ROUTER,BACKEND Create Facility Delete Facility Show Facility Trim Facility Initialize Journal LOG LOGRTR 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=20000Monitor Monitor monitor-ﬁle-specMonitor-ﬁle-spec IDENTIFICATION=process-id Noidentification DRTR Monitor TRAFFIC/COUNT=10/OUTPUT=PICTURE.LIS Quit QuitRecall command-speciﬁer Command-speciﬁerRecall Register Resource Manager Register RM ResourcenameResourcename 106RTR Command Line Interface Scroll Scroll direction amountDirection AmountSET Environment SET EnvironmentCluster NODE=node-listSET Facility SET Facility facility-nameBalance Nobalance RTR SET Facility FINANCE/QUORUMTHRESHOLD=4 RTR SET Facility FINANCE/BALANCESET Link SET Link link-nameEnable Disable Suspect Nosuspect RTR SET Link JOEY/ENABLE RTR SET Link JOEY/AUTOISOLATESET LOG SET LOGRTR SET LOG/FILE=RTRLOG.LOG/OPERATOR RTR SET LOG/NOFILE/NOOPERATORRTR SET LOG/OPERATOR SET Mode SET ModeGROUP=user-id NogroupRTR SET MODE/GROUP RTR SET MODE/NOGROUPSET Node SET nodeRTR SET Node /NOISOLATE SET Partition SET Partition partition-namePartition-name RECOVERYRETRYCOUNT=n RestartrecoveryPRIORITYLIST=backend-node-list ResumeTimeout SuspendSET Transaction SET Transaction transaction-idFacility FACILITY=RTR$DEFAULTFACILITY D Usage NotesTransaction-id BEFORE=dateNewstate 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 CLICHN2Show 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=9Show 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 BackendRTR Show FACILITY/BALANCE Show Journal Show JournalCreate Journal Delete Journal Initialize Journal Show KEY Show KEY key-nameRTR Show KEY/FULL Show Link Show Link node-nameNode-name Full RTR Show LINK/FULL IronShow LOG Show LOGRTR Show LOG Show Mode Show ModeRTR Show Mode Show Node Show NodeRTR Show Node Show Partition Show Partition20 Key-Range States 21 Router Partition States RTR Show PARTITION/ROUTER/FULL RTR Show PARTITION/BACKENDShow Partition Show Process Show ProcessProcesses Process-id Process Name Show Requester Show Resource Manager Show RM Show RM resourcenameRmid Show RTR Show RTRStatus D Nostatus RTR Show RTRShow Segment Show SegmentRTR$DEFAULTFACILITY Unsigned Testfac Signed Show Server Show Server22 Key-range States Server Flags RTR Show Server SRVRTR Show SERVER/FULL LowerservShow Transaction Show Transaction24 Transaction Invocation Types 25 Key-Range States Key-Range States RTR Show TRANSACTION/BACKEND/FULLReceiving OriginalSpawn operating-system-command Operating-system-commandSpawn NoutputStart RTR Start RTRASTLM=ast-limit BIOLM=io-buffered174RTR 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 facilitynameRTR RTR SET Environment /NODE=FE,FETRBE,NFE FRONTEND=frontend-listNofrontend D Unregister Resource Manager Unregister RM Creating Monitor Pictures Table A-1 Information ClassesInteractive Deﬁnition of a Monitor Picture Example A-1 Interactive Picture DeﬁnitionSubstitution Symbols Table A-2 Substitution symbolsArithmetic Expressions and Operators Test Picture AT Some Data Item Other Data ItemTable A-3 Arithmetic Operators in Display Commands Example A-2 Arithmetic Operators ExamplesAggregation 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 SystemServer Shadowing and Recovery RTR Journal System Shadow Site Failure and JournalingStandby for Shadows PerformanceServer 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 StatesServer Shadowing and Recovery Client States Client StatesRequester State Transitions CHAN3Server Shadowing and Recovery Partition States Partition StatesPage New Qualiﬁer to Create Facility Command XA SupportMicrosoft DTC Support XA Support IntroductionModiﬁed RTR API RTR Open ChannelRTR 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