Immediate IMMEDIATE=RTR$DEFAULTCHANNEL | Compaq AA-Q88CE-TE specification

CALL RTR_CLOSE_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.

/IMMEDIATE

/IMMEDIATE=RTR$DEFAULT_CHANNEL

Speciﬁes the closing of a channel immediately without sending of a transaction acknowledgement.

Use /IMMEDIATE=RTR_F_CLO_IMMEDIATE to close the channel and recover any accepted transactions on this channel to an alternate server channel.

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

Examples

This command closes the RTR$DEFAULT_CHANNEL.

RTR> CALL RTR_CLOSE_CHANNEL %RTR-S-OK, Normal successful completion

This command closes the channel named ``client1''.

RTR> CALL RTR_CLOSE_CHANNEL/CHANNEL_NAME=CLIENT1 %RTR-S-OK, Normal successful completion

RTR Command Line Interface 6–11

Image 87

Compaq AA-Q88CE-TE manual Immediate IMMEDIATE=RTR$DEFAULTCHANNEL, This command closes the channel named ``client1

Contents

Reliable Transaction Router System Managers Manual June Contents RTR Monitoring Transaction Management RTR Command Line Interface 105 100103 104 XA Support Server Shadowing and RecoveryRTR Utility Error Messages RTR log messages Index Examples Creating Monitor Pictures Tables Arithmetic Operators in Display Commands Page Purpose of this Manual Intended AudienceStructure of Document Related Documentation Readers CommentsConventions Convention Meaning Conventions Used in this GuidePage Getting Started Entering Commands Online Help Introduction Entering Commands Rtralrsta Command ProceduresRemote Commands Introduction Online Help Introduction Remote Commands Introduction Setting Up-An Example Starting and Setting Up RTR Setting Up-An Example FrontendsFERoutersTRBackendsBEExample 2-1 Local Conﬁguration 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 Reconﬁguration 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 Reconﬁguration Using Extend Facility Setting up Callout Servers 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 RTR ACP Virtual Memory Sizing Starting and Setting Up RTR RTR PrivilegesSetting RTR Privileges on OpenVMS Systems Setting RTR Privileges on Windows NT Systems 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 Anonymous Clients Using the Tunnel PreﬁxTroubleshooting Tunnel and Wildcard Connections TCP Services File Interoperation with RTR Version 2 Using DECnet Starting and Setting Up RTR Network Transports 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 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 a Partition? What is Partition Management?Overview Life Cycle of a Partition Partition Naming Binding Server Channels to Named Partitions Explicit Partition CreationPersistence of Partition Deﬁnitions Programmed Partition Management Entering Partition CommandsPartition Management Entering Partition Commands Command Line Usage Programming Information Command Line ExampleManaging Partitions Controlling Shadowing Example usage of the qualiﬁers Controlling Recovery Controlling the Active Site Partition Management Managing Partitions Char Controlling Failover Rtruns32t newLimit Controlling Transaction Replay RTR$DEFAULTFACILITY Displaying Partition InformationPartition Management Displaying Partition Information Transaction Management Command Line Examples Transaction Management OverviewException 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 PID -ALL RTR Monitoring Standard Monitor Pictures Monitor ActiveMonitor APP2ACP Monitor Broadcast Calls RTR Monitoring Standard Monitor Pictures Monitor CallsMonitor Channel Monitor Connects Monitor Facility Monitor Event RTR Monitoring Standard Monitor Pictures Monitor Flow Monitor GroupMonitor Group Fields RTR Monitoring Standard Monitor Pictures Monitor IPC Monitor IpcrateMonitor Journal Monitor Netbytes Monitor Link RTR Monitoring Standard Monitor Pictures Monitor Netstat Monitor PartitMonitor Partition States Monitor Quorum Monitor RecoveryNodea RTR$DEFAULTFACILITY Monitor Queues Monitor Recovery States Monitor RejectsMonitor Rejects Fields Monitor Rejhist Fields RTR Monitoring Standard Monitor Pictures Monitor RejhistMonitor Response Process 38009A8B Quorum Counts by Facility 7-JAN-1999 143248, Node -ALL RTR Monitoring Standard Monitor Pictures Monitor RolequorumMonitor Routers Monitor Routing 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 Servers RTR Monitoring Standard Monitor Pictures Monitor TPSMonitor Trafﬁc Monitor Trans RTR Monitoring Standard Monitor Pictures Monitor V2CALLS Monitor XAMonitor XA Page RTR Command Reference RTR Command Line Interface ADD Facility Call Rtraccepttx Call RtraccepttxFormat Description Independent Noindependent CHANNELNAME=RTR$DEFAULTCHANNELQualiﬁers Forget Noforget Accept the current transaction with a reason Related Commands Message-ﬁeld1 ,message-ﬁeld2 Call RtrbroadcasteventParameters Call Rtrbroadcastevent message-ﬁeld1 ,message-ﬁeld2 Parameters for rtrbroadcastevent CHANNELNAME=channel-nameEVENTNUMBER=user-event-number TYPEOFDATA=STRING Signed Unsigned /TYPEOFDATA=STRING D Generated Format StringsLENGTHOFFIELD=ﬁeld-length RECIPIENTSPEC=rcpspc Call Rtrbroadcastevent Call Rtrclosechannel Call RtrclosechannelParameters for rtrclosechannel This command closes the channel named ``client1 Immediate IMMEDIATE=RTR$DEFAULTCHANNEL STATUS=status-code No default Call RtrerrortextCall Rtrerrortext Parameters for rtrerrortext Call Rtrgettid Call RtrgettidParameters 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 KEYn=keysegdesc FACILITY=RTR$DEFAULTFACILITY DFACILITYNAME=facility-name HIGHBOUND=high-bound HIGHBOUND=max-val-for-key-type D LOWBOUND=low-bound LOWBOUND=min-val-for-key-type D Standby D Nostandby PARTITIONNAME=partition-name Call Rtrclosechannel Call Rtrpreparetx Call RtrpreparetxParameters for rtrpreparetx DATA=0 DATA=data 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 message-ﬁeld1 ,message-ﬁeld2 Call Rtrreplytoclient Accept Noaccept 11 Parameters for rtrreplytoclient 12 Generated Format Strings Following example replies a message to the client Call Rtrrequestinfo Call Rtrrequestinfo13 Parameters for rtrrequestinfo SELVAL=item-value No default GETITM=item-name,item-name... No defaultINFCLA=infoclass No default SELITM=item-name No default RTR Call RTRRECEIVEMESSAGE/CHANNEL=INFOCHAN/TIMEOUT Call Rtrsendtoserver Call Rtrsendtoserver message-ﬁeld1 ,message-ﬁeld2Message-ﬁeld ,message-ﬁeld2 Expendable Noexpendable 14 Parameters for rtrsendtoserver Readonly Noreadonly 15 Generated Format Strings Examples Nested Transaction Usage Call RtrstarttxCall Rtrstarttx 16 Parameters for rtrstarttx Ddtm JOINTXID=txid-numberNojointxid Txidtype 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 Unix 17 Platform Speciﬁc Information Delete Journal Modify Journal Show Journal Create Partition PartitionnamePartitionname Facility Create Facility SET Partition Key names Define /KEYDefine /KEY key-name equivalence-string Key-name Echo D Noecho Equivalence-string RTR Define /KEY PF1 Create /TERMINATE /IFSTATE=GOLD /ECHO RTR Define /KEY PF3 Show RTR /TERMINATERTR PF3 RTR Define /KEY PF1 Help /SETSTATE=GOLD /NOTERMINATE /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 Display BAR expressionExpression AVERAGE=keyword NoaverageCHARACTER=char Noseparate SEPARATE=keyword TOTALIZE=keyword Nototalize=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=ﬁeld-width /WIDTH=0 D 80RTR Command Line Interface Display Symbolic expression text-string ,text-string Display Symbolic 82RTR Command Line Interface Display Text Display Text textText Node Nonode Related Commands DCL-command Do operating-system-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 facilityname Extend Facility ROUTER=FETRBE $ RTR RTR SET Environment /NODE=FE,FETRBEBACKEND=FETRBE $ RTR 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 RTR Modify Journal DISK1$/BLOCKS=3000/MAXIMUMBLOCKS=20000 OpenVMS Example Monitor Monitor monitor-ﬁle-specMonitor-ﬁle-spec Noidentification D IDENTIFICATION=process-id 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 Amount ScrollScroll direction amount Direction NODE=node-list SET EnvironmentSET Environment Cluster 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/FILE=RTRLOG.LOG/OPERATOR RTR SET LOG/NOFILE/NOOPERATORRTR SET LOG/OPERATOR Nogroup SET ModeSET Mode GROUP=user-id RTR SET MODE/NOGROUP RTR SET MODE/GROUP SET node SET Node RTR SET Node /NOISOLATE SET Partition SET Partition partition-namePartition-name Resume RECOVERYRETRYCOUNT=nRestartrecovery PRIORITYLIST=backend-node-list Suspend Timeout SET Transaction transaction-id SET Transaction BEFORE=date Facility FACILITY=RTR$DEFAULTFACILITY DUsage Notes Transaction-id Newstate 19 Valid Transaction State ChangesSINCE=date RTR SET Transaction /NEW=ABORT /CURRENT=VOTED /PART=DBPART Show Channel Show Channel channel-nameChannel-name CLICHN2 RTR$DEFAULTCHANNELRTR Show CHANNEL/ALLWINDOWS Clichn Show Client Show ClientFull none D RTR Show CLIENT/FULL TEST43CLI Show Display Show Display=column /Y=row WIDTH=9 RTR MON Calls RTR Show DISPLAY/ALLDisplay Numeric Blank Show Environment Show EnvironmentRTR SET ENVIRONMENT/NODE=FE2,FE3 RTR Show Environment Show Facility Show Facility facility-nameFacility-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 Show Link node-nameNode-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 Partition20 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 Server22 Key-range States Server Flags Lowerserv RTR Show ServerSRV RTR Show SERVER/FULL Show Transaction Show Transaction24 Transaction Invocation Types 25 Key-Range States Original Key-Range StatesRTR Show TRANSACTION/BACKEND/FULL Receiving Noutput Spawn operating-system-commandOperating-system-command Spawn 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 RTRAbort 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 Deﬁnition Interactive Deﬁnition of a Monitor Picture Test Picture AT Some Data Item Other Data Item Substitution SymbolsTable A-2 Substitution symbols Arithmetic Expressions and Operators Example A-2 Arithmetic Operators Examples Table A-3 Arithmetic Operators in Display Commands Some output has been omitted for clarity Aggregation of Data ItemsPage Automatic Features Primary and Secondary RolesShadow 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 Server Shadowing and Recovery Performance Shadows in ActionApplication Considerations Server Shadowing and Recovery Application Considerations Server StatesCHAN2 Figure B-2 Server States Server Shadowing and Recovery Server States CHAN3 Server Shadowing and Recovery Client StatesClient States Requester State Transitions Partition States Server Shadowing and Recovery Partition StatesPage XA Support New Qualiﬁer to Create Facility Command RTR Open Channel Microsoft DTC SupportXA Support Introduction Modiﬁed RTR API 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