Manuals / Compaq / Computer Equipment / Network Router

Compaq AA-Q88CE-TE manual Qualiﬁers, Channelname=Rtr$Defaultchannel, Forget Noforget, REASON=0

Models: AA-Q88CE-TE

1 320

Download 320 pages 38.47 Kb

Page 80

CALL RTR_ACCEPT_TX

Qualiﬁers

/CHANNEL_NAME=channel_name

/CHANNEL_NAME=RTR$DEFAULT_CHANNEL

Speciﬁes the channel for which the operation is to be performed.

The command server uses a combination of the channel_name and the window from which the call was issued to uniquely identify which channel to use.

channel_name is not case sensitive.

The default channel name is RTR$DEFAULT_CHANNEL.

/CLUSTER /NOCLUSTER (D)

Speciﬁes that the command is executed on all the nodes in the cluster.

If neither /NODE nor /CLUSTER is speciﬁed then the command is executed on the nodes speciﬁed by the latest SET ENVIRONMENT command. If no SET ENVIRONMENT command has been entered then the command is executed only on the node where the command was issued.

Note: In environments that do not support clustering, use of the /CLUSTER qualiﬁer will cause the relevant command to be executed on the local node only.

/FORGET

/NOFORGET

Use /FORGET to specify the flags parameter as RTR_F_ACC_FORGET in the call rtr_accept_tx( ).

The default for value for /FORGET is /NOFORGET, which causes the command server to use the value RTR_NO_FLAGS for the flags parameter in the call to rtr_accept_tx( ).

/INDEPENDENT NOINDEPENDENT

Use the /INDEPENDENT qualiﬁer to specify the ﬂags parameter RTR_F_ACC_ INDEPENDENT in the call to rtr_accept_txt( ).

/NODE[=node-list] /NODE=default-node-list (D)

Speciﬁes that the command is executed on all nodes speciﬁed in node-list. If node-listis omitted then the command is executed only on the node where the command was issued.

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

/REASON[=reason]

/REASON=0

Use /REASON to supply a value for the reason parameter in the call to rtr_accept_tx( ).

The default for value for /REASON is 0, which causes the command server to use the value RTR_NO_REASON for the reason parameter in the call to rtr_accept_tx( ).

6–4RTR Command Line Interface

Image 80

Compaq AA-Q88CE-TE manual Qualiﬁers, Channelname=Rtr$Defaultchannel, Forget Noforget, Independent Noindependent, REASON=0

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 Structure of Document Purpose of this ManualIntended Audience Conventions Related DocumentationReaders Comments 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 IntroductionExample 2-1 Local Conﬁguration of each Node Starting and Setting Up RTR Setting Up-An ExampleFrontendsFERoutersTRBackendsBE 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 FacilityExample 2-5 Conﬁguration of Callout Servers Starting and Setting Up RTR 2.5 Setting up Callout ServersRouter Load Balancing RTR Privileges Starting and Setting Up RTR Router Load BalancingSetting RTR Privileges on Unix Systems 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 DECnet$ DEFINE/SYSTEM Rtrprefprot Rtrdnafirst Running RTR as a Service on Windows NTNetwork Protocol Selection on OpenVMS Files Created by the RTR Windows NT Service Active How RTR Selects Processing-states Roles for NodesRole Assignment for Backend Node Partitions 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 Overview What is a Partition?What is Partition Management? Partition Naming Life Cycle of a PartitionPersistence of Partition Deﬁnitions Binding Server Channels to Named PartitionsExplicit Partition Creation 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 newLimitPartition Management Displaying Partition Information RTR$DEFAULTFACILITYDisplaying Partition Information Transaction Management Exception Transactions Command Line ExamplesTransaction Management Overview 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 FacilityMonitor Group Fields RTR Monitoring Standard Monitor Pictures Monitor FlowMonitor Group Monitor Journal RTR Monitoring Standard Monitor Pictures Monitor IPCMonitor Ipcrate Monitor Link Monitor NetbytesMonitor Partition States RTR Monitoring Standard Monitor Pictures Monitor NetstatMonitor Partit Monitor Recovery Nodea RTR$DEFAULTFACILITYMonitor Queues Monitor QuorumMonitor Rejects Fields Monitor Recovery StatesMonitor Rejects 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 ServersMonitor XA RTR Monitoring Standard Monitor Pictures Monitor V2CALLSMonitor 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-ﬁeld2EVENTNUMBER=user-event-number Parameters for rtrbroadcasteventCHANNELNAME=channel-name Generated Format Strings LENGTHOFFIELD=ﬁeld-lengthRECIPIENTSPEC=rcpspc TYPEOFDATA=STRING Signed Unsigned /TYPEOFDATA=STRING DCall Rtrbroadcastevent Parameters for rtrclosechannel Call RtrclosechannelCall Rtrclosechannel Immediate IMMEDIATE=RTR$DEFAULTCHANNEL This command closes the channel named ``client1Call Rtrerrortext Call RtrerrortextParameters for rtrerrortext STATUS=status-code No defaultParameters for rtrgettid Call RtrgettidCall 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 Parameters for rtrpreparetx Call RtrpreparetxCall Rtrpreparetx DATA=data DATA=0Prepare the current transaction with a reason Parameters for rtrreceivemessage Call RtrreceivemessageCall Rtrreceivemessage 26RTR Command Line Interface Msgsb msgtype msglen usrhdl 0 tid 10 Parameters for rtrrejecttx Call RtrrejecttxCall 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 13 Parameters for rtrrequestinfo Call RtrrequestinfoCall 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 Message-ﬁeld ,message-ﬁeld2 Call RtrsendtoserverCall Rtrsendtoserver message-ﬁeld1 ,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 =column =row ClearClear 46RTR Command Line Interface Facilityname Create FacilityCreate Facility facilityname Default for role-list is ROUTER,BACKEND RESOURCEMANAGER=resource-list 50RTR Command Line Interface Disk-1, ... disk-n Create JournalCreate Journal disk-1 ... ,disk-n 17 Platform Speciﬁc Information UnixDelete Journal Modify Journal Show Journal Partitionname Create PartitionPartitionname 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 Expression Display BARDisplay BAR expression CHARACTER=char AVERAGE=keywordNoaverage SEPARATE=keyword Noseparate=column TOTALIZE=keywordNototalize =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 Text Display TextDisplay Text text Node Nonode Related Commands Do operating-system-command DCL-commandRTR DO/NODE=TR2,TR1 Show Logical Mylogical ExampleRTR DO/CLUSTER Show Time Flush Namecache Flush Namecacheﬁle-spec ExecuteExecute ﬁ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 Disk-1 ... disk-n Modify JournalModify Journal disk-1 ... ,disk-n OpenVMS Example RTR Modify Journal DISK1$/BLOCKS=3000/MAXIMUMBLOCKS=20000Monitor-ﬁle-spec MonitorMonitor monitor-ﬁle-spec IDENTIFICATION=process-id Noidentification DRTR Monitor TRAFFIC/COUNT=10/OUTPUT=PICTURE.LIS Quit QuitRecall Recall command-speciﬁerCommand-speciﬁer Resourcename Register Resource Manager Register RMResourcename 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/OPERATOR RTR SET LOG/FILE=RTRLOG.LOG/OPERATORRTR SET LOG/NOFILE/NOOPERATOR SET Mode SET ModeGROUP=user-id NogroupRTR SET MODE/GROUP RTR SET MODE/NOGROUPSET Node SET nodeRTR SET Node /NOISOLATE Partition-name SET PartitionSET Partition partition-name RECOVERYRETRYCOUNT=n RestartrecoveryPRIORITYLIST=backend-node-list ResumeTimeout SuspendSET Transaction SET Transaction transaction-idFacility FACILITY=RTR$DEFAULTFACILITY D Usage NotesTransaction-id BEFORE=dateSINCE=date Newstate19 Valid Transaction State Changes RTR SET Transaction /NEW=ABORT /CURRENT=VOTED /PART=DBPART Channel-name Show ChannelShow Channel channel-name RTR$DEFAULTCHANNEL RTR Show CHANNEL/ALLWINDOWSClichn CLICHN2Full none D Show ClientShow Client CLI RTR Show CLIENT/FULLTEST43 =column /Y=row Show DisplayShow Display RTR MON Calls RTR Show DISPLAY/ALL Display NumericBlank WIDTH=9RTR SET ENVIRONMENT/NODE=FE2,FE3 RTR Show Environment Show EnvironmentShow Environment Facility-name Show FacilityShow Facility facility-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 Node-name Show LinkShow Link node-name Full RTR Show LINK/FULL IronShow LOG Show LOGRTR Show LOG Show Mode Show ModeRTR Show Mode Show Node Show NodeRTR Show Node 20 Key-Range States Show PartitionShow Partition 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 22 Key-range States Show ServerShow Server Server Flags RTR Show Server SRVRTR Show SERVER/FULL Lowerserv24 Transaction Invocation Types Show TransactionShow Transaction 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 Abort Stop RTRStop RTR 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 Shadow Events Automatic FeaturesPrimary and Secondary Roles Server Shadowing and Recovery Automatic Features RTR Journal SystemServer Shadowing and Recovery RTR Journal System Shadow Site Failure and JournalingStandby for Shadows PerformanceApplication Considerations Server Shadowing and Recovery PerformanceShadows in Action CHAN2 Server Shadowing and Recovery Application ConsiderationsServer States 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