Compaq AA-Q88CE-TE manuel d'utilisation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320

Aller à la page of

Un bon manuel d’utilisation

Les règles imposent au revendeur l'obligation de fournir à l'acheteur, avec des marchandises, le manuel d’utilisation Compaq AA-Q88CE-TE. Le manque du manuel d’utilisation ou les informations incorrectes fournies au consommateur sont à la base d'une plainte pour non-conformité du dispositif avec le contrat. Conformément à la loi, l’inclusion du manuel d’utilisation sous une forme autre que le papier est autorisée, ce qui est souvent utilisé récemment, en incluant la forme graphique ou électronique du manuel Compaq AA-Q88CE-TE ou les vidéos d'instruction pour les utilisateurs. La condition est son caractère lisible et compréhensible.

Qu'est ce que le manuel d’utilisation?

Le mot vient du latin "Instructio", à savoir organiser. Ainsi, le manuel d’utilisation Compaq AA-Q88CE-TE décrit les étapes de la procédure. Le but du manuel d’utilisation est d’instruire, de faciliter le démarrage, l'utilisation de l'équipement ou l'exécution des actions spécifiques. Le manuel d’utilisation est une collection d'informations sur l'objet/service, une indice.

Malheureusement, peu d'utilisateurs prennent le temps de lire le manuel d’utilisation, et un bon manuel permet non seulement d’apprendre à connaître un certain nombre de fonctionnalités supplémentaires du dispositif acheté, mais aussi éviter la majorité des défaillances.

Donc, ce qui devrait contenir le manuel parfait?

Tout d'abord, le manuel d’utilisation Compaq AA-Q88CE-TE devrait contenir:
- informations sur les caractéristiques techniques du dispositif Compaq AA-Q88CE-TE
- nom du fabricant et année de fabrication Compaq AA-Q88CE-TE
- instructions d'utilisation, de réglage et d’entretien de l'équipement Compaq AA-Q88CE-TE
- signes de sécurité et attestations confirmant la conformité avec les normes pertinentes

Pourquoi nous ne lisons pas les manuels d’utilisation?

Habituellement, cela est dû au manque de temps et de certitude quant à la fonctionnalité spécifique de l'équipement acheté. Malheureusement, la connexion et le démarrage Compaq AA-Q88CE-TE ne suffisent pas. Le manuel d’utilisation contient un certain nombre de lignes directrices concernant les fonctionnalités spécifiques, la sécurité, les méthodes d'entretien (même les moyens qui doivent être utilisés), les défauts possibles Compaq AA-Q88CE-TE et les moyens de résoudre des problèmes communs lors de l'utilisation. Enfin, le manuel contient les coordonnées du service Compaq en l'absence de l'efficacité des solutions proposées. Actuellement, les manuels d’utilisation sous la forme d'animations intéressantes et de vidéos pédagogiques qui sont meilleurs que la brochure, sont très populaires. Ce type de manuel permet à l'utilisateur de voir toute la vidéo d'instruction sans sauter les spécifications et les descriptions techniques compliquées Compaq AA-Q88CE-TE, comme c’est le cas pour la version papier.

Pourquoi lire le manuel d’utilisation?

Tout d'abord, il contient la réponse sur la structure, les possibilités du dispositif Compaq AA-Q88CE-TE, l'utilisation de divers accessoires et une gamme d'informations pour profiter pleinement de toutes les fonctionnalités et commodités.

Après un achat réussi de l’équipement/dispositif, prenez un moment pour vous familiariser avec toutes les parties du manuel d'utilisation Compaq AA-Q88CE-TE. À l'heure actuelle, ils sont soigneusement préparés et traduits pour qu'ils soient non seulement compréhensibles pour les utilisateurs, mais pour qu’ils remplissent leur fonction de base de l'information et d’aide.

Table des matières du manuel d’utilisation

  • Page 1

    Reliable T ransaction Router System Manager ’ s Manual Order Number: AA-Q88CE-TE June, 1999 This manual describes how to configure, manage and monitor Reliable T ransaction Router , V ersion 3.2 (RTR). Revision/Update Information: This manual supersedes V ersion 3.1D of the System Manager ’ s Manual Software V ersion: Reliable T ransaction Rou[...]

  • Page 2

    June, 1999 COMP AQ COMPUTER CORPORA TION SHALL NOT BE LIABLE FOR TECHNICAL OR EDITORIAL ERRORS OR OMISSIONS CONT AINED HEREIN, NOR FOR INCIDENT AL OR CONSEQUENTIAL DAMAGES RESUL TING FROM THE FURNISHING, PERFORMANCE, OR USE OF THIS MA TERIAL. THIS INFORMA TION IS PROVIDED "AS IS" AND COMP AQ COMPUTER CORPORA TION DISCLAIMS ANY W ARRANTIES[...]

  • Page 3

    Contents Preface ............................................................ xi 1 Introduction 1.1 Getting Started ............................................. 1–1 1.2 Entering Commands . ........................................ 1–1 1.3 Online Help ................................................ 1–2 1.4 Command Procedures .................[...]

  • Page 4

    3.3 Life Cycle of a Partition . . . .................................... 3–2 3.3.1 Implicit Partition Creation .................................. 3–3 3.3.2 Explicit Partition Creation .................................. 3–3 3.3.3 Persistence of Partition Definitions ........................... 3–3 3.4 Binding Server Channels to Named Partit[...]

  • Page 5

    5.2.14 Monitor IPCRA TE ........................................ 5–10 5.2.15 Monitor Journal . . ........................................ 5–10 5.2.16 Monitor Link ............................................ 5–1 1 5.2.17 Monitor Netbytes . ........................................ 5–1 1 5.2.18 Monitor Netstat . . ............................[...]

  • Page 6

    DISPLA Y BAR . . ............................................ 6–67 DISPLA Y NUMERIC ......................................... 6–72 DISPLA Y STRIN G........................................... 6–77 DISPLA Y SYMBOLIC ........................................ 6–81 DISPLA Y TEXT . ............................................ 6–83 D O ..........[...]

  • Page 7

    STOP RTR . ................................................ 6–177 TRIM F ACILITY ............................................ 6–179 UNREGISTER RESOURCE MANAGER (UNREGISTER RM) . . ....... 6–182 A Creating Monitor Pictures A.1 Interactive Definition of a Monitor Picture . ....................... A–2 A.2 Substitution Symbols . ..............[...]

  • Page 8

    Figures 2–1 Configuration Example .................................... 2–2 2–2 Extend Configuration Example . . ............................ 2–6 A–1 Interactively Defined Monitor Picture ......................... A–3 B–1 Four Node Shadow/Standby Configuration . . . ................... B–4 B–2 Server States ....................[...]

  • Page 9

    A–3 Arithmetic Operators in Display Commands .................... A–4 ix[...]

  • Page 10

    [...]

  • Page 11

    Preface Purpose of this Manual This manual describes how to configure, manage and monitor the operation of Reliable T ransaction Router (RTR) using the RTR Command Line Interface (CLI). Intended Audience The System Manager ’ s Manual is intended for persons who perform system management functions to configure, test, monitor and maintain RTR app[...]

  • Page 12

    Related Documentation • Release Notes • Installation Guide • Application Programmer ’ s Reference Manual • Application Design Guide • Migration Guide Reader ’ s Comments Compaq welcomes your comments on this manual. Please send us your comments by email to rtrdoc@compaq.com . Include the title of the manual, section and page numbers w[...]

  • Page 13

    T able 1 Conventions Used in this Guide Convention Meaning UPPERCASE lowercase Some operating systems differentiate between lowercase and uppercase characters. For these systems, examples, syntax descriptions, function definitions, and literal strings that appear in text must be typed exactly as shown. Commands typed to the RTR CLI are not case se[...]

  • Page 14

    [...]

  • Page 15

    1 Introduction For a general introduction to Reliable T ransaction Router , V ersion 3.2 (RTR), you should read the introductory chapter in the Reliable T ransaction Router Application Design Guide . Additional information about the Reliable T ransaction Router is available in the Reliable T ransaction Router Application Programmer ’ s Reference [...]

  • Page 16

    Introduction 1.2 Entering Commands or , when several commands are to be entered at the RTR prompt: % rtr RTR> start rtr RTR> create journal Note For convenience, the user prompt for the operating system is shown here as the ‘‘%’ ’ symbol. Y our system may have a different prompt. The RTR CLI accepts commands that you type and can proc[...]

  • Page 17

    Introduction 1.3 Online Help where error-identification is the identification part of the returned error . The following sequence returns an error message, RTRALRSTA , that can then be explained by the help errors rtralrsta command option: % rtr RTR> start rtr %RTR-F-RTRALRSTA, rtr already started RTR> help errors rtralrsta Errors RTRALRSTA [...]

  • Page 18

    Introduction 1.5 Remote Commands This command starts RTR on the three nodes. Note The /CLUSTER and /NOCLUSTER command qualifiers refer to cluster support. These qualifiers are for operating systems that fully support clustering. Use of the /CLUSTER qualifier on systems that do not have clustering causes the relevant command to be executed on the[...]

  • Page 19

    2 Starting and Setting Up RTR This chapter describes how to configure and start an RTR environment. Recovery journals, router load balancing and call-out servers are also discussed. 2.1 Introduction Before RTR applications can run, RTR must be started and the application’s facility must be defined on each node of the application’ s environmen[...]

  • Page 20

    Starting and Setting Up RTR 2.2 Setting Up—An Example Figure 2–1 Configuration Example F E 1 F E 2 F E 3 T R 1 T R 2 B E 1 B E 2 B E 3 SMM_CONFIG_EX 01−99 F r o n t e n d R o u t e r s ( T R ) B a c k e n d s ( B E ) s ( F E ) In this example, the application client processes run on the nodes FE1, FE2 and FE3. The servers run on BE1, BE2 and[...]

  • Page 21

    Starting and Setting Up RTR 2.2 Setting Up—An Example Example 2–2 illustrates how to use RTR remote commands to start the same configuration. The set environment command is used to send subsequent commands to a number of RTR nodes. Example 2–2 Remote Setup from one Node % rtr RTR> set environment/node= - _RTR> (FE1, FE2, FE3, TR1, TR2,[...]

  • Page 22

    Starting and Setting Up RTR 2.3 Creating a Recovery Journal • The operator should move any duplicate copies of journal files to a location other than the rtrjnl/groupname directory so that RTR will see only the one it created. • T rack duplicate copies of journal files in the log file to prevent RTR seeing more than the one it created and is[...]

  • Page 23

    Starting and Setting Up RTR 2.4 Changing a Facility Example 2–3 Reconfiguration Using Delete and Create Facility % rtr RTR> stop rtr/node=FE3 1 RTR> delete facility funds_transfer/node=TR2 2 RTR> create facility funds_transfer/node=TR2 - 3 _RTR> /frontend=(FE1,FE2) - _RTR> /router=TR2 ) RTR> delete facility funds_transfer/node=[...]

  • Page 24

    Starting and Setting Up RTR 2.4 Changing a Facility Figure 2–2 Extend Configuration Example SMM_CONFIG_EX_EXT 02−99 F E 1 F E 2 F E 3 F E 4 T R 1 T R 2 T R 3 B E 1 B E 2 B E 3 B A C K E N D S R O U T E R S F R O N T E N D S All backend nodes must be informed when router configurations are changed. Because TR3 will be a router for the FE3 and [...]

  • Page 25

    Starting and Setting Up RTR 2.4 Changing a Facility Example 2–4 Reconfiguration Using Extend Facility % RTR RTR> start rtr /node=(TR3,FE4) RTR> set environment/node= - 1 _RTR> (FE1,FE2,FE3,TR1,TR2,BE1,BE2,BE3,TR3,FE4) RTR> extend facility funds_transfer - 2 _RTR> /router=TR3/frontend=(FE3,FE4) - _RTR> /backend=(BE1,BE2,BE3) RTR[...]

  • Page 26

    Starting and Setting Up RTR 2.5 Setting up Callout Servers Example 2–5 Configuration of Callout Servers % rtr RTR> set environment/node= - _RTR> (FE1,FE2,FE3,TR1,TR2,BE1,BE2,BE3) RTR> start rtr RTR> create facility funds_transfer/frontend=(FE1,FE2,FE3) - _RTR> /router=(TR1,TR2) - _RTR> /backend=(BE1,BE2,BE3) - _RTR> /call_ou[...]

  • Page 27

    Starting and Setting Up RTR 2.6 Router Load Balancing • Use /balance on frontend nodes only . Use of /balance on routers is supported only to enable RTR V ersion 2 balancing. Use this qualifier only when you are connecting frontend nodes running RTR V ersion 2. See CREA TE F ACILITY and SET F ACILITY for more information on /balance . • Comman[...]

  • Page 28

    Starting and Setting Up RTR 2.7 RTR Privileges The rtrinfo group is currently only used to allow applications to call rtr_request_info( ) For other users, create the groups rtroper and rtrinfo Users who do not fall into the above categories, but are members of the rtrinfo group can only use RTR commands that display information (SHOW , MONITOR, cal[...]

  • Page 29

    Starting and Setting Up RTR 2.8 RTR ACP Virtual Memory Sizing • Add the size of all messages 2. For each transaction router: • Allow one Kbyte for each active transaction 3. For each back end: • Allow one Kbyte per active transaction • Allow fifty bytes for each message of a transaction • Add the size of all replies The total of all the [...]

  • Page 30

    Starting and Setting Up RTR 2.8 RTR ACP V irtual Memory Sizing Use of /LINK and /PROCESSES do not take into account memory requirements for transactions. If an application passes a large amount of data from client to server or vice-versa this should be included in the sizing calculations. For further information on the ST ART RTR qualifiers see th[...]

  • Page 31

    Starting and Setting Up RTR 2.8 RTR ACP Virtual Memory Sizing A minimum of 419430 Kbytes for heap data segment sizing A minimum of 33555 Kbytes for core file size A minimum of 8389 Kbytes for stack segment size A minimum of 0 for CPU time • On HPUX: A minimum of 1024 open file descriptors The ST ART RTR qualifiers /LINK and /PROCESSES apply on[...]

  • Page 32

    Starting and Setting Up RTR 2.9 Network T ransports 2.9.2 Using RTR with DHCP and Internet T unnels When using RTR with DHCP or an Internet tunnel, a nodename may not be fully known; special naming techniques are provided for these conditions. Anonymous Clients RTR allows the use of wild cards when specifying the frontends that a router is permitte[...]

  • Page 33

    Starting and Setting Up RTR 2.9 Network T ransports This informs the system administrator that port number 46000/tcp is reserved for RTR. (Note that the RTR daemon is started by RTRACP and not by inetd ). 2.9.3 Interoperation with RTR V ersion 2 Using DECnet Reliable T ransaction Router is interoperable with RTR V ersion 2.2D ECO3 or later when run[...]

  • Page 34

    Starting and Setting Up RTR 2.10 Network Protocol Selection on OpenVMS 2.10 Network Protocol Selection on OpenVMS • The default network transport protocol on OpenVMS is DECnet. Y ou may change the default to TCP/IP by removing this line from RTR$STARTUP.COM : $ DEFINE/SYSTEM RTR_PREF_PROT RTR_DNA_FIRST If you are using TCP/IP , you will need to u[...]

  • Page 35

    Starting and Setting Up RTR 2.1 1 Running RTR as a Service on W indows NT 2.1 1.1 Customizing the RTR Windows NT Service While starting RTR, the Service looks for the file UsrStart.RTR in the RTR home directory . On finding the file, the Service executes any RTR commands it may contain. RTR commands from UsrStart.RTR execute after RTR has been s[...]

  • Page 36

    Starting and Setting Up RTR 2.12 How RTR Selects Processing-states (Roles) for Nodes 2.12 How RTR Selects Processing-states (Roles) for Nodes This section discusses how RTR assigns roles to backend node partitions, and how routers are selected. 2.12.1 Role Assignment for Backend Node Partitions RTR assigns a primary or secondary processing state to[...]

  • Page 37

    Starting and Setting Up RTR 2.12 How RTR Selects Processing-states (Roles) for Nodes The SHOW P ARTITION command on each backend node is as follows: Backend partitions on node BRONZE in group "test" at Mon Mar 22 14:52:32 1999 Partition name: p1 Facility: RTR$DEFAULT_FACILITY State: pri_act Low bound: 0 High bound: 4294967295 Active serve[...]

  • Page 38

    Starting and Setting Up RTR 2.12 How RTR Selects Processing-states (Roles) for Nodes 8. The network connection to node Gold is reestablished. The partition on Gold retained its original sequence number of 2 and retains the primary role while the partition on Bronze reassumes the secondary role. Alternately , the roles of backend nodes can be speci?[...]

  • Page 39

    Starting and Setting Up RTR 2.12 How RTR Selects Processing-states (Roles) for Nodes Router Site A Site B Node-A1 Node-A2 Node-B1 Node-B2 If the relative priority (sequence number) for Node-A2 is changed to four it still becomes the primary active server if Node-A1 fails because the failover policy indicates a fail_to_standby requirement for this f[...]

  • Page 40

    Starting and Setting Up RTR 2.12 How RTR Selects Processing-states (Roles) for Nodes relevant to a backend. It is where the backend goes to obtain and verify partition configuration and facility information. Routers are made known to the frontend systems through the list specified in the /ROUTER=(list) qualifier to the CREA TE F ACILITY command.[...]

  • Page 41

    3 Partition Management 3.1 Overview This section describes the concepts and operations of RTR’ s partitions. 3.1.1 What is a Partition? Partitions are subdivisions of a routing key range of values. They are used with a partitioned data model and RTR data content routing. Partitions exist for each distinct range of values in the routing key for wh[...]

  • Page 42

    Partition Management 3.2 Partition Naming 3.2 Partition Naming A prerequisite for partition management is the ability to identify a partition in the system that is to be the subject of management commands. For this purpose, partitions have been given names, which may be drawn from a number of sources described below . 3.2.1 Default Partition Names [...]

  • Page 43

    Partition Management 3.3 Life Cycle of a Partition 3.3.1 Implicit Partition Creation Partitions are created implicitly when an application program calls rtr_open_channel( ) to create a server channel, specifying the key segments and value ranges for the segments with the pkeyseg argument. Other partition attributes are established with the flags ar[...]

  • Page 44

    Partition Management 3.5 Entering Partition Commands 3.5 Entering Partition Commands Partitions can be managed by issuing partition commands directed at the required partition after they are created. Partition commands can be entered in one of two ways: • A command line processed by the RTR command line interface, for example RTR> SET PARTITIO[...]

  • Page 45

    Partition Management 3.5 Entering Partition Commands The rtr_set_info( ) call completes asynchronously . If the function call is successful, completion will be signaled by the delivery of an RTR message of type rtr_mt_closed on the channel whose identifier is returned through the pchannel argument. The programmer should retrieve this message by us[...]

  • Page 46

    Partition Management 3.6 Managing Partitions 3.6.2 Controlling T ransaction Presentation T ransaction presentation is the process of passing transactions to idle server channels for processing. While transaction presentation is active, new transactions are started on the first free server channel for the appropriate partition. Use the /SUSPEND qua[...]

  • Page 47

    Partition Management 3.6 Managing Partitions If a partition enters a wait state or fails but has neither a local or remote journal, an operator can instruct RTR to skip the current step in the recovery process with the /IGNORE_RECOVERY qualifier . Since this command bypasses parts of the recovery cycle use it with caution in cases where availabili[...]

  • Page 48

    Partition Management 3.6 Managing Partitions 3.6.4.2 Programming Information T o set the partition backend priority list, program the set_qualifier argument of the rtr_set_info( ) call as follows: rtr_qualifier_value_t set_qualifiers[ 2 ]; char *szNodeList = "your,list,of,node,names,here" set_qualifiers[ 0 ].qv_qualifier = rtr_partition_b[...]

  • Page 49

    Partition Management 3.6 Managing Partitions • rtr_partition_fail_to_shadow • rtr_partition_pre32_compatible 3.6.6 Controlling T ransaction Replay RTR has implemented the capability of controlling transaction replay in cases where a "killer message" happens during a transaction replay preventing recovery from continuing normally . A &[...]

  • Page 50

    Partition Management 3.7 Displaying Partition Information 3.7 Displaying Partition Information Information on the definition and state of a partition is displayed with the SHOW PARTITION command. The information of interest in the context of partition management relates to the backend instance of the partition. For more information see the SHOW P [...]

  • Page 51

    4 T ransaction Management 4.1 Overview This section describes the concepts of RTR’ s transaction management capability . The RTR transaction is the heart of an RTR application, and transaction state is the property that characterizes a transaction’ s current condition. Whenever a transaction progresses from one stage to another , the transactio[...]

  • Page 52

    T ransaction Management 4.1 Overview this transaction is removed from memory and can no longer be monitored by the command. The RTR DUMP JOURNAL command can be used to trace and review the flow of a transaction. The RTR journal saves all of the information about a transaction, its transaction journal state, the transaction messages (records) recei[...]

  • Page 53

    T ransaction Management 4.1 Overview 4.1.2 T ransaction State Changes There are eight valid state changes allowed for the SET TRANSACTION command. Attempting to change transaction state to a state that is not allowed produces an error message of %RTR-E-INVSTATCHANGE, Invalid to change from current state to the specified state . The T able 6–19 ta[...]

  • Page 54

    T ransaction Management 4.1 Overview This is the case where, for example, a server crashed while performing an SQL commit immediately after receiving a mt_accepted message. The transaction is in COMMIT state as recorded in the RTR journal and the transaction is also committed in the underlying database. After the SET TRANSACTION command is executed[...]

  • Page 55

    5 RTR Monitoring This chapter contains a description of the RTR monitor . The RTR monitor gives you a means of viewing the activities of RTR and your applications. Many different aspects of RTR’ s behaviour can be viewed, allowing the activities and performance of RTR to be analyzed. 5.1 Introduction The RTR monitor provides a means to continuous[...]

  • Page 56

    RTR Monitoring 5.2 Standard Monitor Pictures Note Obsolete monitor pictures have been removed from the documentation. T able 5–1 Standard Monitor Pictures Picture name Description accfail Shows link transport name for links on which a connection attempt was declined, with a reason for failure. The most recent entry is highlighted. acp2app Display[...]

  • Page 57

    RTR Monitoring 5.2 Standard Monitor Pictures T able 5–1 (Cont.) Standard Monitor Pictures Picture name Description jcalls Displays counts of successful (success), failed (fail) and total journal calls for local and remote journals. journal Displays the current journal usage on a node. Local node journal statistics are provided, and data for non-l[...]

  • Page 58

    RTR Monitoring 5.2 Standard Monitor Pictures T able 5–1 (Cont.) Standard Monitor Pictures Picture name Description traffic Displays a list of the links to other nodes. Shown for each link are: byte rate, packet rate, message rate and congestion, in both directions. A verage packets per second is also shown. trans Displays transactions for a fron[...]

  • Page 59

    RTR Monitoring 5.2 Standard Monitor Pictures your domain name, depending on how the name is entered in either your local hosts file or name server . DECnet-Plus systems may yield both a pseudonym and a link name; both are checked for a match with a template. • RTR_STS_F ACNOTDEC - "facility name not matched" The connecting link is con?[...]

  • Page 60

    RTR Monitoring 5.2 Standard Monitor Pictures 5.2.3 Monitor Active ACTIVE TRANSACTIONS BY PROCESS Fri Mar 12 1999 19:32:41 Starts Completions Active All processes: 5 5 0 Node ID Process Image NodeA 11141 11141 rtr 5 5 0 Displays a list of RTR processes, and for each process the number of transactions they have started, the number of transactions the[...]

  • Page 61

    RTR Monitoring 5.2 Standard Monitor Pictures 5.2.6 Monitor Calls RTR api calls, Node: nodea.zuo.dec.com , PID: 2162 , Process name: -ALL- Image: -ALL- Fri Feb 12 1999 16:38:05 CALLS client server fail MESSAGES client server pend open_channel 1 1 0 mt_opened 1 1 0 close_channel 0 0 0 mt_closed 0 0 0 start_tx 0 0 mt_msg1 0 1 send_to_server 1 0 mt_msg[...]

  • Page 62

    RTR Monitoring 5.2 Standard Monitor Pictures Displays the link protocol for connected links, and the fail reason as a text message for any links on which a connection has failed. Unconnected links where connection have been attempted are highlighted. Link state and architecture of the remote node are also displayed. Summarizes link status and is le[...]

  • Page 63

    RTR Monitoring 5.2 Standard Monitor Pictures 5.2.1 1 Monitor Flow FLOW CONTROL COUNTERS 7-JAN-1999 14:08:06, NODE: -ALL- , FACILITY: -ALL- CREDIT DATA RATE REQUESTS GRANTS ROLE AVAILABLE BYTES/SEC WAITS SENT PENDING SENT PENDING FE=>TR 15000 2065 307 966 0 966 0 TR=>BE 15000 2065 70 998 0 998 0 BE=>TR 0 0 0 0 0 0 0 TR=>FE 15000 0 0 2 0 [...]

  • Page 64

    RTR Monitoring 5.2 Standard Monitor Pictures 5.2.13 Monitor IPC RTR> Monitor IPC Node: LENGTH I P C S u mmary F r iM a r 5 1999 11:18:34 +----------------------------------------------------------------------------+ This screen displays usage information on IPC messages, byte counts and IO primitives. Display units are counts, kbytes and calls r[...]

  • Page 65

    RTR Monitoring 5.2 Standard Monitor Pictures Displays information about journal usage, including total number of entries and records written, number of records read, and how many bytes were involved. Bar graphs showing current usage of journal blocks (as a percentage of the total) are also provided. The local journal figures refer to journal usage[...]

  • Page 66

    RTR Monitoring 5.2 Standard Monitor Pictures 5.2.18 Monitor Netstat Connection Status Detail Node: NODEA Mon March 15 1999 09:50:28 Ini Cnf Acc Abo Rej Loss Gain Ctmo Rstr State Type FailCode Node Link 12 0 2 12 12 1 3 0 0 NODEA ->nodeb 0 00000100u p alpha NODEA ->nodec 6 00660000 down ? 76490676 NODEA ->noded 6 00660000 down ? 76490676 NO[...]

  • Page 67

    RTR Monitoring 5.2 Standard Monitor Pictures T able 5–3 (Cont.) Monitor Partition States State Meaning active Server is active pri_act Server is active as primary shadow sec_act Server is active as secondary shadow remember Primary is running without shadow secondary 5.2.20 Monitor Queues TRANSACTION QUEUES BY PARTITION 15-JAN-1999 12:42:53, NODE[...]

  • Page 68

    RTR Monitoring 5.2 Standard Monitor Pictures Server recovery state meanings are shown in T able 5–4. T able 5–4 Monitor Recovery States State Meaning wt_tr_ok Server is waiting for routers to accept it wt_quorum Server is waiting for backend to be quorate lcl_rec Local recovery lcl_rec_fail Primary server waiting for access to a restart journal[...]

  • Page 69

    RTR Monitoring 5.2 Standard Monitor Pictures 5.2.24 Monitor Rejhist Rejected Transaction History NODE: NODEA PROCESS: 38009A8B Mon Mar 9 1999 10:26:14 Time Chan Reason Status Text ------------------- ------ ------- -------------------------------------- Mon Mar 15 18:06:06 client 0 Client aborted tx Mon Mar 15 18:06:41 server 0 Normal successful co[...]

  • Page 70

    RTR Monitoring 5.2 Standard Monitor Pictures 5.2.26 Monitor Rolequorum QUORUM COUNTS BY FACILITY 7-JAN-1999 14:32:48, NODE: -ALL- Router View of Backend View of backends routers backend routers CNF RCH QRT CNF RCH QRT CNF RCH QRT CNF RCH QRT V I P 111 111 111 111 5.2.27 Monitor Routers ROUTER TRANSACTION COUNTERS AT 14:33:29 7-JAN-1999 Node: -ALL- [...]

  • Page 71

    RTR Monitoring 5.2 Standard Monitor Pictures 5.2.29 Monitor RSCBE RTR> Monitor rscbe Most Recent RSC Dclsrv Calls History on Backend LENGTH Thu Mar 4 1999,15:19:41 Key Range Id: 16777216 Partition Start Time: THU MAR 4 15:18:22 1999 Image Name: RTR.EXE T-delta RSC calls router state seq_nr 0 send_dcl_to_master sfranc wait_for_response 0 1 recv_s[...]

  • Page 72

    RTR Monitoring 5.2 Standard Monitor Pictures 5.2.31 Monitor Stalls NETWORK STALLS AT 29-JAN-1999 15:35:03, ON NODE: TR1 QIOs Bytes Link Stalls Issued Rate Sent Drops Secs <3s <10s <30s >30s Tot Total 5467 0.0 327148 2 33 23 1 0 0 24 TR1 -> TR1 29 0.0 3718 0 0 0 0 0 0 0 TR1 -> FE2 509 0.0 20707 0 4 4 0 0 0 4 TR1 -> BE1 303 0.0 1[...]

  • Page 73

    RTR Monitoring 5.2 Standard Monitor Pictures 5.2.32 Monitor System System Status at 10:27:51 Fri Apr 9 1999 node: NODEA Resource OK Warning Facility QUORUM states...... x JOURNAL free space.......... x Note: Additional detail Link CONNECTS............... x about a resource can be obtained by monitoring Link traffic STALLS......... x the subsystem s[...]

  • Page 74

    RTR Monitoring 5.2 Standard Monitor Pictures 5.2.33 Monitor TPS TRANSACTION COMMITS BY PROCESS 14:37:23 7-JAN-1999 Commits Node ID Process Abs. Rate 10 20 30 40 50 60 70 80 90 100 -ALL- 00000000 -REQUESTERS- 123298 31.8 -ALL- 00000000 -SERVERS- 123297 28.9 NODEA 20200BEA RTRACP 0 0.0 NODEA 20200C03 ANDERS_1 123297 28.9 NODEB 21400724 RTRACP 0 0.0 N[...]

  • Page 75

    RTR Monitoring 5.2 Standard Monitor Pictures 5.2.36 Monitor V2CALLS RTR> Monitor V2CALLS RTR system service calls, Node: NODEA , PID: 00000000, Process name: -ALL- Image: -ALL- 13:09:18 5-MAR-1999 Accept Reject Success Failure Outstng Calls dcl_tx_prc/server 3 0 4 0 0 4 dcl_tx_prc/req. 1 dcl_tx_prc/shut. 0 start_tx 1 0 1 0 0 1 start_tx /timeout [...]

  • Page 76

    [...]

  • Page 77

    6 RTR Command Line Interface Each RTR API call can be invoked at CLI level using the RTR command utility . This is provided to facilitate testing. For example, clients may be tested before the corresponding servers have been written by manually entering the server ’ s API calls. 6.1 Introduction The commands that invoke the RTR API calls are simi[...]

  • Page 78

    ADD F ACILITY ADD F ACILITY See CREA TE F ACILITY ; ADD F ACILITY is retained for compatibility reasons only . 6–2 RTR Command Line Interface[...]

  • Page 79

    CALL RTR_ACCEPT_TX CALL RTR_ACCEPT_TX The CALL RTR_ACCEPT_TX command causes a command server to execute the rtr_accept_tx( ) routine and to display the returned status. Format CALL RTR_ACCEPT_TX Command Qualifiers Defaults /CHANNEL_NAME=channel-name /CHANNEL_NAME=RTR$DEF AUL T_CHANNEL /CLUSTER /NOCLUSTER /FORGET /NOFORGET /INDEPENDENT NOINDEPENDEN[...]

  • Page 80

    CALL RTR_ACCEPT_TX Qualifiers /CHANNEL_NAME=channel_name /CHANNEL_NAME=RTR$DEF AUL T_CHANNEL Specifies 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 de[...]

  • Page 81

    CALL RTR_ACCEPT_TX Related Commands • CALL RTR_OPEN_CHANNEL • CALL RTR_REJECT_TX Examples Accept the current transaction with a reason of 42. RTR> CALL RTR_ACCEPT_TX /REASON=42 %RTR-S-OK, normal successful completion RTR Command Line Interface 6–5[...]

  • Page 82

    CALL RTR_BROADCAST_EVENT CALL RTR_BROADCAST_EVENT The CALL RTR_BROADCAST_EVENT command causes a command server to execute the rtr_broadcast_event( ) routine and to display the returned status. Format CALL RTR_BROADCAST_EVENT [message-field1] [,message-field2...] Parameters [message-field1] [,message-field2...] Specify the message to be sent (if[...]

  • Page 83

    CALL RTR_BROADCAST_EVENT T able 6–2 Parameters for rtr_broadcast_event C Parameter Name C Parameter V alue Command Line Specification channel /CHANNEL_NAME=name flags RTR_NO_FLAGS [none] [D] pmsg, msglen, msgfmt 1 [message definition parameter list with positional qualifiers. ] evtnum 42 /EVENT_NUMBER=42 rcpspc "workstat*" /RECIPIEN[...]

  • Page 84

    CALL RTR_BROADCAST_EVENT T able 6–3 Generated Format Strings Data T ype With /LENGTH= With /NOLENGTH STRING =n, "%nC" "%nC" where n=strlen(string) SIGNED =1, "%SB" "%SL" SIGNED =2, "%SW" "%SL" SIGNED =4, "%SL" "%SL" UNSIGNED =1, "%UB" "%SL" UNSIGNE[...]

  • Page 85

    CALL RTR_BROADCAST_EVENT RTR> CALL RTR_BROADCAST_EVENT "Dollar is up"/EVENT_NUMBER=23 %RTR-S-OK, Normal successful completion The following command broadcasts user event number 24 to all recipients whose /RECIPIENT_NAME matches the DEALER% string (that is, DEALER1, DEALER2, DEALERx). Note that only the event is broadcast, there is no a[...]

  • Page 86

    CALL RTR_CLOSE_CHANNEL CALL RTR_CLOSE_CHANNEL The CALL RTR_CLOSE_CHANNEL command causes a command server to execute the rtr_close_channel( ) routine and to display the returned status. Format CALL RTR_CLOSE_CHANNEL Command Qualifiers Defaults /CHANNEL_NAME=channel-name /CHANNEL_NAME=RTR$DEF AUL T_CHANNEL /CLUSTER /NOCLUSTER /IMMEDIA TE /IMMEDIA TE[...]

  • Page 87

    CALL RTR_CLOSE_CHANNEL /CLUSTER /NOCLUSTER (D) Specifies that the command is executed on all the nodes in the cluster . If neither /NODE nor /CLUSTER is specified then the command is executed on the nodes specified by the latest SET ENVIRONMENT command. If no SET ENVIRONMENT command has been entered then the command is executed only on the node [...]

  • Page 88

    CALL RTR_ERROR_TEXT CALL RTR_ERROR_TEXT The CALL RTR_ERROR_TEXT command causes a command server to execute the rtr_error_text( ) routine and to display the returned error text. Format CALL RTR_ERROR_TEXT Command Qualifiers Defaults /OUTPUT[=file-spec] /OUTPUT=stdout /ST A TUS=status-code /none Description The CALL RTR_ERROR_TEXT command causes a [...]

  • Page 89

    CALL RTR_GET_TID CALL RTR_GET_TID The CALL RTR_GET_TID command causes a command server to execute the rtr_get_tid( ) routine and to display the returned status. Format CALL RTR_GET_TID Command Qualifiers Defaults /CHANNEL_NAME=channel-name /CHANNEL_NAME=RTR$DEF AUL T_CHANNEL /CLUSTER /NOCLUSTER /NODE[=node-list] /NODE=default-node-list /OUTPUT[=?[...]

  • Page 90

    CALL RTR_GET_TID If neither /NODE nor /CLUSTER is specified then the command is executed on the nodes specified 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 [...]

  • Page 91

    CALL RTR_OPEN_CHANNEL CALL RTR_OPEN_CHANNEL The CALL RTR_OPEN_CHANNEL command causes a command server to execute the rtr_open_channel( ) routine and to display the returned status. Format CALL RTR_OPEN_CHANNEL Command Qualifiers Defaults /ACCEPT_EXPLICIT /NOACCEPT_EXPLICIT /ACCESS=access /NOACCESS /BE_CALL_OUT /NOBE_CALL_OUT /CHANNEL_NAME=channel-[...]

  • Page 92

    CALL RTR_OPEN_CHANNEL rtr_status_t rtr_open_channel ( rtr_channel_t *pchannel, rtr_ope_flag_t flags, rtr_facnam_t facnam, rtr_rcpnam_t rcpnam, rtr_evtnum_t *pevtnum, rtr_access_t access, rtr_numseg_t numseg, rtr_keyseg_t *pkeyseg ); T able 6–7 shows the correspondence between values you supply on the command line and the C language parameter valu[...]

  • Page 93

    CALL RTR_OPEN_CHANNEL /ACCESS=access /NOACCESS (D) Specifies an access string (that is, a password). All application programs (clients and servers) must specify the same access string for a given facility . /BE_CALL_OUT /NOBE_CALL_OUT (D) Specifies that the RTR_F_OPE_BE_CALL_OUT flag is set in the flags parameter in the call to rtr_open_channel([...]

  • Page 94

    CALL RTR_OPEN_CHANNEL /F ACILITY_NAME=facility-name /F ACILITY=RTR$DEF AUL T_F ACILITY (D) Specifies the name of the facility for which the channel is declared. An application must specify the facility name when using the RTR CLI. The default facility name is RTR$DEF AUL T_F ACILITY . /FOREIGN_TM[=tm_id] /NOFOREIGN_TM (D) V alid for client channel[...]

  • Page 95

    CALL RTR_OPEN_CHANNEL length_of_key=nnnn Specifies the length of the key field in enqueued messages in bytes. Use this qualifier only if the key field type is string, since the key length is in other cases implied by the key type. The default value for key-length is four bytes. offset_of_key=nnnn Specifies the offset of the key within the mess[...]

  • Page 96

    CALL RTR_OPEN_CHANNEL /OFFSET_OF_KEY=offset /OFFSET_OF_KEY=0 (D) Specifies 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 definition is allowed. /OUTPUT[=file-spec] /OUTPUT=stdout (D) Specifies that the resulting information is written to [...]

  • Page 97

    CALL RTR_OPEN_CHANNEL /TYPE_OF_FIELD=key-field-type /TYPE_OF_FIELD=UNSIGNED (D) Specifies the field type of the key . The key-type must be one of UNSIGNED, SIGNED or STRING. The default is UNSIGNED. Related Commands • CALL RTR_CLOSE_CHANNEL Examples This command opens a server channel called RTR$DEF AUL T_CHANNEL that may not have concurrent s[...]

  • Page 98

    CALL RTR_PREP ARE_TX CALL RTR_PREP ARE_TX The CALL RTR_PREP ARE_TX command causes a command server to execute the rtr_prepare_tx( ) routine and to display the returned status. Format CALL RTR_PREP ARE_TX Command Qualifiers Defaults /CHANNEL_NAME=channel-name /CHANNEL_NAME=RTR$DEF AUL T_CHANNEL /DA T A[=data] /DA T A=0 /NODE[=node-list] /NODE=defau[...]

  • Page 99

    CALL RTR_PREP ARE_TX The CALL RTR_PREP ARE_TX can only be used in the context of nested transactions (rtr_start_tx was called with the parameter join_txid not equal to NOJOIN_TXID). If this call returns RTR_STS_OK, then the first (prepare) phase of the RTR 2PC protocol has been initiated. The message type associated with this command is rtr_mt_pre[...]

  • Page 100

    CALL RTR_PREP ARE_TX /REASON[=reason] /REASON=0 Use /REASON to supply a value for the reason parameter in the call to rtr_prepare_tx( ) . The reason parameter to rtr_prepare_tx( ) is used in place of the reason parameter in the subsequent rtr_accept_tx call( ) (that is, the reason field in the call to rtr_accept_tx call( ) or rtr_reject_tx( ) whic[...]

  • Page 101

    CALL RTR_RECEIVE_MESSAGE CALL RTR_RECEIVE_MESSAGE The CALL RTR_RECEIVE_MESSAGE command causes a command server to execute the rtr_receive_message( ) routine and to display the returned status. Format CALL RTR_RECEIVE_MESSAGE Command Qualifiers Defaults /CHANNEL_NAME=channel-name /CHANNEL_NAME=RTR$DEF AUL T_CHANNEL /CLUSTER /NOCLUSTER /NODE[=node-l[...]

  • Page 102

    CALL RTR_RECEIVE_MESSAGE For all messages received, RTR displays the contents of the message status block (msgsb) as follows: the message type (for example, rtr_mt_opened , rtr_mt_msgn ). the message length in bytes the transaction ID, user handle, are event number are shown if they are relevant for the message type. For message types that place a [...]

  • Page 103

    CALL RTR_RECEIVE_MESSAGE /TIMEOUT_MS=timoutms /TIMEOUT_MS=0 (D) The timoutms argument defines a timeout for the receive, in milliseconds. The default value is an infinite timeout. /TIMEOUT_MS specifies an immediate timeout. Examples The following example shows two CALL RTR_RECEIVE_MESSAGE commands on RTR$DEF AUL T_CHANNEL. RTR> CALL RTR_RECEI[...]

  • Page 104

    CALL RTR_REJECT_TX CALL RTR_REJECT_TX The CALL RTR_REJECT_TX command causes a command server to execute the rtr_reject_tx( ) routine and to display the returned status. Format CALL RTR_REJECT_TX Command Qualifiers Defaults /CHANNEL_NAME=channel-name /CHANNEL_NAME=RTR$DEF AUL T_CHANNEL /CLUSTER /NOCLUSTER /NODE[=node-list] /NODE=default-node-list /[...]

  • Page 105

    CALL RTR_REJECT_TX channel_name is not case sensitive. The default channel name is RTR$DEF AUL T_CHANNEL. /CLUSTER /NOCLUSTER (D) Specifies that the command is executed on all the nodes in the cluster . If neither /NODE nor /CLUSTER is specified then the command is executed on the nodes specified by the latest SET ENVIRONMENT command. If no SET [...]

  • Page 106

    CALL RTR_REJECT_TX Examples Reject the current transaction with a reason of 42. RTR> CALL RTR_REJECT_TX /REASON=42 %RTR-S-OK, normal successful completion 6–30 RTR Command Line Interface[...]

  • Page 107

    CALL RTR_REPL Y_TO_CLIENT CALL RTR_REPL Y_T O_CLIENT The CALL RTR_REPL Y_TO_CLIENT command causes a command server to execute the rtr_reply_to_client( ) routine and to display the returned status. Format CALL RTR_REPL Y_TO_CLIENT [message-field1] [,message-field2...] Parameters [message-field1] [,message-field2...] Specify the message to be sen[...]

  • Page 108

    CALL RTR_REPL Y_TO_CLIENT T able 6–1 1 Parameters for rtr_reply_to_client C Parameter Name C Parameter V alue Command Line Specification channel /CHANNEL_NAME=name flags RTR_NO_FLAGS none [D] RTR_F_REP_ACCEPT /ACCEPT pmsg, msglen, msgfmt 1 [message definition parameter list with positional qualifiers.] 1 The actual values used for pmsg , msgl[...]

  • Page 109

    CALL RTR_REPL Y_TO_CLIENT T able 6–12 Generated Format Strings Data T ype With /LENGTH= With /NOLENGTH STRING =n, "%nC" "%nC" where n=strlen(string) SIGNED =1, "%SB" "%SL" SIGNED =2, "%SW" "%SL" SIGNED =4, "%SL" "%SL" UNSIGNED =1, "%UB" "%SL" UNSIG[...]

  • Page 110

    CALL RTR_REPL Y_TO_CLIENT Examples The following example replies a message to the client. RTR> CALL RTR_REPLY_TO_CLIENT "Getting that info for you" %RTR-S-OK, Normal successful completion The following example shows a message of type unsigned and entered as a hexadecimal number . RTR> CALL RTR_REPLY_TO_CLIENT "0xFA9BC0"/TY[...]

  • Page 111

    CALL RTR_REQUEST_INFO CALL RTR_REQUEST_INFO The CALL RTR_REQUEST_INFO command causes a command server to execute the rtr_request_info( ) routine and to display the returned status. Format CALL RTR_REQUEST_INFO Command Qualifiers Defaults /CHANNEL_NAME=channel-name /CHANNEL_NAME=RTR$DEF AUL T_CHANNEL /CLUSTER /NOCLUSTER /GETITM=item-name none /INFC[...]

  • Page 112

    CALL RTR_REQUEST_INFO Qualifiers /CHANNEL_NAME=channel_name /CHANNEL_NAME=RTR$DEF AUL T_CHANNEL Specifies 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[...]

  • Page 113

    CALL RTR_REQUEST_INFO Examples This command requests the backend transaction IDs for the facility ‘‘CASHF AC’’. RTR> CALL RTR_REQUEST_INFO/CHANNEL=INFOCHAN /INFCLA="btx"/SELITM=fac_id/SELVAL=CASHFAC /GETITMS=tb_txdx.tx_id The information can then be viewed by repeatedly executing the following command until the channel is close[...]

  • Page 114

    CALL RTR_SEND_TO_SER VER CALL RTR_SEND_TO_SER VER The CALL RTR_SEND_TO_SER VER command causes a command server to execute the rtr_send_to_server( ) routine and to display the returned status. Format CALL RTR_SEND_T O_SERVER [message-field1] [,message-field2...] Parameters [message-field] [,message-field2...] Specify the message to be sent as on[...]

  • Page 115

    CALL RTR_SEND_TO_SER VER T able 6–14 Parameters for rtr_send_to_server C Parameter Name C Parameter V alue Command Line Specification channel /CHANNEL_NAME=name flags RTR_NO_FLAGS none [D] RTR_F_SEN_EXPENDABLE /EXPENDABLE RTR_F_SEN_READONL Y /READONL Y RTR_F_SEN_RETURN_TO_SENDER /RETURN_TO_SENDER pmsg, msglen, msgfmt 1 [message definition para[...]

  • Page 116

    CALL RTR_SEND_TO_SER VER If /FORMA T is specified without fmt-string , RTR automatically generates a format string. The format string is generated using the parameters given for the qualifiers /SIGNED, /UNSIGNED, /STRING and /LENGTH. The following table shows permitted values for these qualifiers when using /FORMA T without fmt-string . T able 6[...]

  • Page 117

    CALL RTR_SEND_TO_SER VER Examples This command sends a message to a server . The message is type string (the default). RTR> CALL RTR_SEND_TO_SERVER "Get that info for me, please" %RTR-S-OK, Normal successful completion RTR Command Line Interface 6–41[...]

  • Page 118

    CALL RTR_ST ART_TX CALL RTR_ST ART_TX The CALL RTR_ST ART_TX command causes a command server to execute the rtr_start_tx( ) routine and to display the returned status. Format CALL RTR_ST ART_TX Command Qualifiers Defaults /CHANNEL_NAME=channel-name /CHANNEL_NAME=RTR$DEF AUL T_CHANNEL /CLUSTER /NOCLUSTER /JOIN_TXID=txid-number /NOJOIN_TXID /NODE[=n[...]

  • Page 119

    CALL RTR_ST ART_TX phase cannot be executed on an client FTM channel, may be relaxed in a future release.) When a nested transaction is started (join_txid not equal to NOJOIN_ TXID), then that transaction is given a new RTR TXID (which the operator can retrieve by calling rtr_get_tid). The foreign TXID passed in join_txid is used only to identify t[...]

  • Page 120

    CALL RTR_ST ART_TX /OUTPUT[=file-spec] /OUTPUT=stdout (D) Specifies that the resulting information is written to the file file-spec .I f /OUTPUT or file-spec is omitted then the standard or default output is used. /TIMEOUT_MS=timoutms /TIMEOUT_MS=0 (D) The timoutms argument defines a timeout for the transaction, in milliseconds. The default val[...]

  • Page 121

    CLEAR CLEAR Interactively remove one or more displayed items from a monitor picture. Format CLEAR Command Qualifiers Defaults /ALL /NOALL /X=column /Y=row Description The CLEAR command enables you to interactively remove one or all of the displayed items from a monitor picture. The picture can then be redisplayed using the MONITOR /RESUME command.[...]

  • Page 122

    CLEAR Examples See Section A.1, Interactive Definition of a Monitor Picture, for an example of how to use the CLEAR command. 6–46 RTR Command Line Interface[...]

  • Page 123

    CREA TE F ACILITY CREA TE F ACILITY Create an RTR facility and ready it for transaction traffic. Format CREA TE F ACILITY [facility_name] Command Qualifiers Defaults /ALL_ROLES=node-list /NOALL_ROLES /BACKEND=backend-list /NOBACKEND /BALANCE /NOBALANCE /CALL_OUT=role-list /NOCALL_OUT /CLUSTER /NOCLUSTER /FRONTEND=frontend-list /NOFRONTEND /NODE[=[...]

  • Page 124

    CREA TE F ACILITY Qualifiers /ALL_ROLES=node-list /NOALL_ROLES (D) Specifies the names of the nodes that are to act as frontend, router and backend in this facility . Note that the definition order of nodes may be significant. This applies to the order of router node definitions when frontend load balancing is not enabled. Nodes defined with [...]

  • Page 125

    CREA TE F ACILITY Note: In environments that do not support clustering, use of the /CLUSTER qualifier will cause the relevant command to be executed on the local node only . /FRONTEND=frontend-list /NOFRONTEND (D) Frontend-list is a list of frontend-nodes separated by commas. If there is more than one frontend-node , then frontend-list must be enc[...]

  • Page 126

    CREA TE F ACILITY Examples See Chapter 2, Starting and Setting Up RTR, for examples of how to use the CREATE FACILITY command. 6–50 RTR Command Line Interface[...]

  • Page 127

    CREA TE JOURNAL CREA TE JOURNAL Create RTR’ s recovery journal. Format CREA TE JOURNAL [disk-1] ... [,disk-n] Command Qualifiers Defaults /CLUSTER /NOCLUSTER /BLOCKS=nr-blocks /BLOCKS=1000 /MAXIMUM_BLOCKS=nr-blocks /MAXIMUM_BLOCKS=1000 /NODE=node-list /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout /SUPERSEDE /NOSUPERSEDE Description[...]

  • Page 128

    CREA TE JOURNAL T able 6–17 Platform Specific Information Platform Journal Root Finding Disks Notes UNIX /rtrjnl Use df Enter disk names as thay appear in /dev . Enclose disk names in quotes and separate names with commas. The journals reside in subdirectories of the /rtrjnl . OpenVMS [RTRJNL] Use SHOW DEVICE If the SYSTEM account has insuffici[...]

  • Page 129

    CREA TE JOURNAL If /NOSUPERSEDE is specified (default), then a journal is created only if no journal previously existed. Related commands • DELETE JOURNAL • MODIFY JOURNAL • SHOW JOURNAL Examples RTR> CREATE JOURNAL /SUPERSEDE DISK1$:/BLOCK=1000/MAX_BLOCK=10000, - _RTR> DISK2$:/BLOCK=2000/MAX_BLOCK=200000 This command deletes any exist[...]

  • Page 130

    CREA TE P ARTITION CREA TE P ARTITION Creates an RTR partition. Format CREA TE P ARTITION [partition_name] Command Qualifiers Defaults /CLUSTER /NOCLUSTER /CONCURRENT /NOCONCURRENT /F ACILITY=facility-name /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout /ST ANDBY /NOST ANDBY /SHADOW /NOSHADOW /KEY1=keysegdesc /KEYn=ke[...]

  • Page 131

    CREA TE P ARTITION /CONCURRENT (D) /NOCONCURRENT Specifies that concurrent servers are allowed for this partition. /KEYn=keysegdesc Specifies a partition key segment. Up to nine key segments may be defined for a partition (KEY1, KEY2,... up to KEY9). (If more than nine key segements are required, a named partiton can be created using the rtr_ope[...]

  • Page 132

    CREA TE P ARTITION /ST ANDBY (D) /NOST ANDBY Specifies that standby servers are allowed for this partition. /SHADOW /NOSHADOW (D) Specifies that shadow servers are allowed for this partition. /OUTPUT[=file-spec] /OUTPUT=stdout (D) Specifies that the resulting information is written to the file file-spec .I f /OUTPUT or file-spec is omitted the[...]

  • Page 133

    DEFINE /KEY DEFINE /KEY Assign a string to a keyboard function key . Format DEFINE /KEY key-name "equivalence-string" Command Qualifiers Defaults /ECHO /ECHO /IF_ST A TE /NOIF_ST A TE /LOCK_ST A TE /NOLOCK_ST A TE /LOG /NOLOG /SET_ST A TE /NOSET_ST A TE /TERMINA TE /NOTERMINA TE Description This command lets you assign a string to a func[...]

  • Page 134

    DEFINE /KEY T able 6–18 (Cont.) Key names Key-name LK201 VT100-type PF4 PF4 PF4 KP0, KP1 ..KP9 Keypad 0 .. 9 Keypad 0 .. 9 PERIOD Keypad period (.) Keypad period (.) COMMA Keypad comma (,) Keypad comma (,) MINUS Keypad minus (-) Keypad minus (-) ENTER ENTER ENTER E1 Find E2 Insert Here E3 Remove E4 Select E5 Prev Screen E6 Next Screen HELP Help D[...]

  • Page 135

    DEFINE /KEY /LOG /NOLOG (D) Controls whether a message is displayed indicating that the key definition has been successfully created. /SET_ST A TE=state-name /NOSETST A TE (D) Controls whether pressing the key changes the current key state. /SET_STATE changes the current state to state-name when you press the key . /NOSET_STATE (the default) cause[...]

  • Page 136

    DEFINE /KEY The word DEF AUL T in the second line of the example refers to the fact that PF1 has been defined in the default state. Note the space before the word CREA TE in the second DEFINE /KEY command. If the space is omitted, the system fails to recognize CREA TE as the keyword for the HELP command. 6–60 RTR Command Line Interface[...]

  • Page 137

    DELETE F ACILITY DELETE F ACILITY Delete an RTR facility . Format DELETE F ACILITY facility_name Command Qualifiers Defaults /CLUSTER /NOCLUSTER /NODE=node-list /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The DELETE FACILITY command removes the specified facility on the node where the command is issued. After issuing t[...]

  • Page 138

    DELETE F ACILITY Related Commands • CREATE FACILITY • SHOW FACILITY Examples See Chapter 2, Starting and Setting Up RTR, for examples of how to use the DELETE FACILITY command. 6–62 RTR Command Line Interface[...]

  • Page 139

    DELETE JOURNAL DELETE JOURNAL Delete an RTR journal. Format DELETE JOURNAL Command Qualifiers Defaults /CLUSTER /NOCLUSTER /NODE=node-list /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The DELETE JOURNAL command deletes a previously created RTR journal on the node where the command is issued. The DELETE JOURNAL command wi[...]

  • Page 140

    DELETE JOURNAL Examples See Chapter 2, Starting and Setting Up RTR, for examples of how to use the DELETE JOURNAL command. 6–64 RTR Command Line Interface[...]

  • Page 141

    DELETE P ARTITION DELETE P ARTITION Delete an RTR P ARTITION. Format DELETE P ARTITION P ARTITION_name Command Qualifiers Defaults /CLUSTER /NOCLUSTER /NODE=node-list /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout /F ACILITY Description The DELETE PARTITION command removes the specified partition on the node where the command is issu[...]

  • Page 142

    DELETE P ARTITION Related Commands • CREATE PARTITION • SHOW PARTITION 6–66 RTR Command Line Interface[...]

  • Page 143

    DISPLA Y BAR DISPLA Y BAR Display a bar-graph in a monitor picture. Format DISPLA Y BAR expression Command Qualifiers Defaults /A VERAGE=(keyword,...) /none /BELL=Boolean-expression /NOBELL /BLANK=Boolean-expression /NOBLANK /BLINK=Boolean-expression /NOBLINK /BOLD=Boolean-expression /BOLD /CHARACTER=char /CHARACTER="a" /DAMPING=damping-[...]

  • Page 144

    DISPLA Y BAR Qualifiers /A VERAGE=(keyword,...) /NOA VERAGE Specifies that the items being monitored relating to keyword are displayed as an average. This allows a number of items to be averaged in one qualifier . The keyword can be one of the following: Keyword Meaning NODE Node data items LINK Link data items F ACILITY Facility data items PROC[...]

  • Page 145

    DISPLA Y BAR /LABEL=text /NOLABEL (D) Specifies the text used to label the value being displayed. Symbols are substituted at display time. (See Section A.2, Substitution Symbols). /LENGTH[=nr-chars] /LENGTH=50 (D) Specifies the number of characters in a bar chart representing the maximum value. The default is 50. /MAXIMUM[=max-value] /MAXIMUM=10 [...]

  • Page 146

    DISPLA Y BAR Keyword Meaning PROCESS Process data items P ARTITION Partition data items FE_TRANSACTION Frontend transaction data items TR_TRANSACTION Backend transaction data items BE_TRANSACTION Router transaction data items /TOT ALIZE=(keyword,...) /NOTOT ALIZE Specifies that the items being monitored relating to keyword are added together and d[...]

  • Page 147

    DISPLA Y BAR /X=previous-column (D) Specifies the screen column where the item is displayed (the leftmost column is 1). By default, items are displayed in the same column as defined by the previous DISPLA Y command. /Y[=row] /Y=next-free-row (D) Specifies the screen row where the item is displayed (top row is 1). By default, items are displayed [...]

  • Page 148

    DISPLA Y NUMERIC DISPLA Y NUMERIC Display a number in a monitor picture. Format DISPLA Y NUMERIC expression Command Qualifiers Defaults /A VERAGE=(keyword,...) /none /BELL=Boolean-expression /NOBELL /BLANK=Boolean-expression /NOBLANK /BLINK=Boolean-expression /NOBLINK /BOLD=Boolean-expression /NOBOLD /DAMPING=damping-factor /NODAMPING /DECIMALS=de[...]

  • Page 149

    DISPLA Y NUMERIC The keyword can be one of the following: Keyword Meaning NODE Node data items LINK Link data items F ACILITY Facility data items PROCESS Process data items P ARTITION Partition data items FE_TRANSACTION Frontend transaction data items TR_TRANSACTION Backend transaction data items BE_TRANSACTION Router transaction data items /BELL[=[...]

  • Page 150

    DISPLA Y NUMERIC /RA TE[=interval] /NORA TE (D) Specifies that the rate of change of the expression is to be displayed rather than the absolute value. When /RATE is used, interval specifies the time interval in seconds used to calculate the rate of change. This has no effect on the sampling, it simply allows the rate to be displayed in another un[...]

  • Page 151

    DISPLA Y NUMERIC Keyword Meaning LINK Link data items F ACILITY Facility data items PROCESS Process data items P ARTITION Partition data items FE_TRANSACTION Frontend transaction data items TR_TRANSACTION Backend transaction data items BE_TRANSACTION Router transaction data items /UNDERLINE[=Boolean-expression] /NOUNDERLINE (D) Specifies that the [...]

  • Page 152

    DISPLA Y NUMERIC Related Commands • MONITOR • SHOW DISPLAY • CLEAR • DISPLAY BAR • DISPLAY SYMBOLIC • DISPLAY TEXT Examples See Section A.1 for examples of how to use the DISPLAY NUMERIC command. 6–76 RTR Command Line Interface[...]

  • Page 153

    DISPLA Y STRING DISPLA Y STRING Display a string in a monitor picture. Format DISPLA Y STRING expression Command Qualifiers Defaults /A VERAGE=(keyword,...) /none /BELL=Boolean-expression /NOBELL /BLANK=Boolean-expression /NOBLANK /BLINK=Boolean-expression /NOBLINK /BOLD=Boolean-expression /BOLD /JUSTIFY=keyword /JUSTIFY=LEFT /LABEL=text /NOLABEL [...]

  • Page 154

    DISPLA Y STRING The keyword can be one of the following: Keyword Meaning NODE Node data items LINK Link data items F ACILITY Facility data items PROCESS Process data items P ARTITION Partition data items FE_TRANSACTION Frontend transaction data items TR_TRANSACTION Backend transaction data items BE_TRANSACTION Router transaction data items /BLANK[=[...]

  • Page 155

    DISPLA Y STRING /SEP ARA TE=(keyword,...) /NOSEP ARA TE Specifies that the items being monitored relating to keyword are separated from each other and displayed as a list. This allows a number of items to be separated in one qualifier . The keyword can be one of the following: Keyword Meaning NODE Node data items LINK Link data items F ACILITY Fa[...]

  • Page 156

    DISPLA Y STRING /X[=column] /X=previous-column (D) Specifies the screen column where the item is displayed (the leftmost column is 1). By default, items are displayed in the same column as defined by the previous DISPLA Y command. /Y[=row] /Y=next-free-row (D) Specifies the screen row where the item is displayed (top row is 1). By default, items[...]

  • Page 157

    DISPLA Y SYMBOLIC DISPLA Y SYMBOLIC Display a text in a monitor picture depending on the result of an expression evaluation. Format DISPLA Y SYMBOLIC expression "text-string" [,"text-string"]... Command Qualifiers Defaults /BELL=Boolean-expression /NOBELL /BLANK=Boolean-expression /NOBLANK /BLINK=Boolean-expression /NOBLINK /BO[...]

  • Page 158

    DISPLA Y SYMBOLIC /BOLD[=Boolean-expression] /NOBOLD (D) Specifies that the item is displayed in high intensity if Boolean-expression evaluates to T rue (non-zero). /REVERSE[=Boolean-expression] /NOREVERSE (D) Specifies that the item is displayed with the foreground and background visual attributes swapped if Boolean-expression evaluates to T rue[...]

  • Page 159

    DISPLA Y TEXT DISPLA Y TEXT Display text in a monitor picture. Format DISPLA Y TEXT text Command Qualifiers Defaults /BELL=Boolean-expression /NOBELL /BLANK=Boolean-expression /NOBLANK /BLINK=Boolean-expression /NOBLINK /BOLD=Boolean-expression /NOBOLD /F ACILITY /NOF ACILITY /LINK /NOLINK /NODE /NODE /PROCESS /NOPROCESS /REVERSE=Boolean-expressio[...]

  • Page 160

    DISPLA Y TEXT /BOLD[=Boolean-expression] /NOBOLD (D) Specifies that the item is displayed in high intensity if Boolean-expression evaluates to T rue (non-zero). /F ACILITY /NOF ACILITY (D) Specifies that the symbol substitution in the text is carried out as if a facility data item were being displayed. This means that the link name symbol ($LINK_[...]

  • Page 161

    DISPLA Y TEXT /UNDERLINE[=Boolean-expression] /NOUNDERLINE (D) Specifies that the displayed value is underlined if Boolean-expression evaluates to T rue (non-zero). /X[=column] /X=previous-column (D) Specifies the screen column where the item is displayed (the leftmost column is 1). By default, items are displayed in the same column as defined b[...]

  • Page 162

    DO DO Execute an operating system command. Format DO [operating-system-command] Command Qualifiers Defaults /CLUSTER /NOCLUSTER /NODE=node-list /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The DO command enables an operating system command to be executed from RTR. By using the /NODE and /CLUSTER qualifiers the command c[...]

  • Page 163

    DO Related Commands • SPAWN Example RTR> DO/CLUSTER SHOW TIME This command shows the time on all nodes in a OpenVMS cluster . RTR> DO/NODE=(TR2,TR1) SHOW LOGICAL MYLOGICAL This command examines the logical name "MYLOGICAL" on nodes TR2 and TR1. RTR> SET ENVIRONMENT/NODE=(TR2,TR1) RTR> DO SHOW TIME RTR> DO SHOW LOGICAL MYL[...]

  • Page 164

    FLUSH NAME_CACHE FLUSH NAME_CACHE Flushes RTR’ s internal network name cache. Format FLUSH NAME_CACHE Command Qualifiers Defaults /CLUSTER /NOCLUSTER /NODE[=node-list] /NODE=default-node-list Description The FLUSH NAME_CACHE removes information for all known nodes from RTR’ s internal network name cache. Network links could become unstable if [...]

  • Page 165

    EXECUTE EXECUTE Executes a file containing RTR commands. Format EXECUTE file-spec Command Qualifiers Defaults /VERIFY /NOVERIFY Description The EXECUTE command reads a file containing RTR commands and executes them. This command also has the form @file-spec . Parameters file-spec Specifies the name of the file containing commands to be execu[...]

  • Page 166

    EXIT EXIT Exits from the RTR prompt. Format EXIT Description The EXIT command exits from the RTR prompt and returns control to the operating system prompt. The command has no parameters or qualifiers. Same as QUIT . 6–90 RTR Command Line Interface[...]

  • Page 167

    EXTEND F ACILITY EXTEND F ACILITY Adds new nodes or roles or both to an existing facility definition. Format EXTEND F ACILITY [facility_name] Command Qualifiers Defaults /BACKEND=backend-list /NOBACKEND /BALANCE /NOBALANCE /CALL_OUT=role-list /NOCALL_OUT /CLUSTER /NOCLUSTER /FRONTEND=frontend-list /NOFRONTEND /NODE[=node-list] /NODE=default-node-[...]

  • Page 168

    EXTEND F ACILITY $ RTR RTR> SET ENVIRONMENT /NODE=(FE,FETRBE) RTR> CREATE FACILITY facnam /FRONTEND=(FE,FETRBE) - /ROUTER=FETRBE - /BACKEND=FETRBE A new frontend NFE can be added to this facility as follows: $ RTR RTR> SET ENVIRONMENT /NODE=(FETRBE,NFE) RTR> EXTEND FACILITY facnam /FRONTEND=NFE - /ROUTER=FETRBE Parameters facility_name [...]

  • Page 169

    EXTEND F ACILITY Backend-list is a list of backend-nodes separated by commas. If there is more than one backend-node , then backend-list must be enclosed in parentheses. Backend-node is either the name of a node or @file-spec , where file-spec specifies a file containing a backend-list on each line. /BALANCE /NOBALANCE (D) Specifies that load ba[...]

  • Page 170

    EXTEND F ACILITY /OUTPUT[=file-spec] /OUTPUT=stdout (D) Specifies that the resulting information is written to the file file-spec .I f /OUTPUT or file-spec is omitted then the standard or default output is used. /ROUTER=router-list /NOROUTER (D) Specifies the names of the added nodes that act as routers for this facility . Router-list is a list[...]

  • Page 171

    INITIALIZE JOURNAL INITIALIZE JOURNAL See CREA TE JOURNAL; INITIALIZE is only retained for compatibility reasons. RTR Command Line Interface 6–95[...]

  • Page 172

    LOG LOG Specify RTR to write a log message to a log file. Format LOG Command Qualifiers Defaults /CLUSTER /NOCLUSTER /NODE=node-list /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The LOG command specifies a defined log entry to be written to its log messages. Y ou can write log messages to the operator console and to a[...]

  • Page 173

    LOG Examples RTR> LOG/OUTPUT=RTRLOG.LOG "Message check here" This command tells RTR to write a log message to the file RTRLOG.LOG. RTR> LOG/CLUSTER="Check for this message to see if logging is working" This command tells RTR to write log messages to all members of a cluster . RTR> LOG/NODE=hostname "Message check [...]

  • Page 174

    MODIFY JOURNAL MODIFY JOURNAL Specifies the desired and maximum allowed sizes of RTR’ s recovery journal. Format MODIFY JOURNAL [disk-1] ... [,disk-n] Command Qualifiers Defaults /CLUSTER /NOCLUSTER /BLOCKS=nr-blocks /BLOCKS=1000 /MAXIMUM_BLOCKS=nr-blocks /MAXIMUM_BLOCKS=1000 /NODE=node-list /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=[...]

  • Page 175

    MODIFY JOURNAL If neither /NODE nor /CLUSTER is specified then the command is executed on the nodes specified 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 qu[...]

  • Page 176

    MONITOR MONIT OR Displays a monitor picture on the screen. Format MONITOR [monitor-file-spec] Command Qualifiers Defaults /CLUSTER /NOCLUSTER /COUNT=nr-updates /COUNT=infinite /F ACILITY=facility-name /NOF ACILITY /IDENTIFICA TION=process-id /NOIDENTIFICA TION /INTERV AL=delay-seconds /INTERV AL=2 /LINK=link-name /NOLINK /NODE=node-list /NODE=de[...]

  • Page 177

    MONITOR Note: In environments that do not support clustering, use of the /CLUSTER qualifier will cause the relevant command to be executed on the local node only . /COUNT=nr-updates /COUNT=infinite (D) Specifies how many times the RTR utility updates the screen before exiting or returning to the RTR> prompt. The default is that RTR updates th[...]

  • Page 178

    MONITOR qualifier can be used to reset all the averages currently being displayed. It is also useful if monitoring is resumed after issuing one or more RTR commands. /VERIFY /NOVERIFY (D) Specifies that the contents of monitor-file-spec are echoed on stdout . This is useful when developing monitor files to find the exact location of syntax erro[...]

  • Page 179

    QUIT QUIT Quits from the RTR prompt. Format QUIT Description The QUIT command exits from the RTR prompt and returns control to the operating system prompt. The command has no parameters or qualifiers. Same as EXIT . RTR Command Line Interface 6–103[...]

  • Page 180

    RECALL RECALL Display a previously entered command for subsequent command editing. Format RECALL [command-specifier] Command Qualifiers Defaults /ALL /NOALL Description When you enter commands to the RTR Utility , they are stored in a recall buffer for later use with the RECALL command. Commands can be recalled by either entering the first few c[...]

  • Page 181

    REGISTER RESOURCE MANAGER (REGISTER RM) REGISTER RESOURCE MANAGER (REGISTER RM) Registers an instance of a resource manager (RM) with RTR. Format REGISTER RESOURCE MANAGER [resource_name] REGISTER RM [resource_name] Command Qualifiers Defaults /open_string /see the Oracle8 Administrator ’s Reference manual /close_string /see the Oracle8 Administ[...]

  • Page 182

    REGISTER RESOURCE MANAGER (REGISTER RM) Examples RTR> REGISTER RM rmi_1/open_string="Oracle_XA+Acc=P/user/pw+SesTm=15+db=accounting" /close_string="" /xaswitch_name=xaosw /library_path="library_path" 6–106 RTR Command Line Interface[...]

  • Page 183

    SCROLL SCROLL Scroll a monitor picture. Format SCROLL direction [amount] Description The SCROLL command causes the the last picture that was displayed using the MONITOR command to be scrolled in the direction specified and then redisplayed. Parameters direction Specifies the direction in which the screen is to be scrolled. Can be one of LEFT , RI[...]

  • Page 184

    SET ENVIRONMENT SET ENVIRONMENT Specify the node(s) where subsequent RTR commands are executed. Format SET ENVIRONMENT Command Qualifiers Defaults /CLUSTER /NOCLUSTER /NODE=node-list /NODE=this_node Description The SET ENVIRONMENT command causes subsequent RTR commands to be executed on the specified nodes. Entering SET ENVIRONMENT without any qu[...]

  • Page 185

    SET F ACILITY SET F ACILITY Sets various facility related options. Format SET F ACILITY facility-name Command Qualifiers Defaults /BROADCAST_MINIMUM_RA TE=Bps /BROADCAST_MINIMUM_RA TE=1000 /QUORUM_THRESHOLD=n /QUORUM_THRESHOLD=0 /BALANCE /NOBALANCE /CLUSTER /NOCLUSTER /NODE=node-list /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout /REP[...]

  • Page 186

    SET F ACILITY Note A node that combines both backend and router roles is counted twice in determining the threshold. A value of zero implies that the RTR determined threshold (half the number of node/role pairs configured plus one) is used. This is the default value; do not alter it unless you are sure that the unreachable nodes are really down. B[...]

  • Page 187

    SET F ACILITY Related Commands • SHOW FACILITY Examples RTR> SET FACILITY FINANCE/QUORUM_THRESHOLD=4 quorum threshold set to 4 (from 0) for facility FINANCE The SET F ACILITY command tells RTR to set the quorum threshold to four for facility FINANCE. This command should be used on all the backend and router nodes in the facility . RTR> SET [...]

  • Page 188

    SET LINK SET LINK Sets various link related options. Format SET LINK link-name Command Qualifiers Defaults /AUTOISOLA TE /NOAUTOISOLA TE /ENABLE /DISABLE /CHECKSUM /NOCHECKSUM /CLUSTER /NOCLUSTER /INACTIVITY_TIMEOUT[=secs] /INACTIVITY_TIMEOUT=node-default /NODE=node-list /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout /SUSPECT /NOSUSPE[...]

  • Page 189

    SET LINK Remote node autoisolation may be enabled (at the isolator) where it applies to all links using SET NODE/AUTOISOLA TE, or for specific links only with the SET LINK/AUTOISOLA TE command. An isolated node (isolatee) remains isolated until you carry out both of the following actions: • Enable the link to the isolated node on all nodes that [...]

  • Page 190

    SET LINK The new value for secs becomes effective only after a time of about one third of the current value of the link inactivity timeout. The minimum useful value for secs is three. If a value is not specified, links inherit the current value of the node inactivity timeout. (See SET NODE /INACTIVITY_TIMEOUT .) Y ou can check the current value of[...]

  • Page 191

    SET LINK Examples RTR> SET LINK JOEY/ENABLE This command re-allows connections from node JOEY . RTR> SET LINK JOEY/AUTOISOLATE This command sets the autoisolate attribute on the link to node JOEY . RTR Command Line Interface 6–1 15[...]

  • Page 192

    SET LOG SET LOG Specify where RTR writes its log messages. Format SET LOG Command Qualifiers Defaults /CLUSTER /NOCLUSTER /FILE=file-spec-list /NOFILE /NODE=node-list /NODE=default-node-list /OPERA TOR /NOOPERA T OR /OUTPUT[=file-spec] /OUTPUT=stdout Description The SET LOG command specifies where RTR writes its log messages. Y ou can write log[...]

  • Page 193

    SET LOG /OPERA TOR /NOOPERA TOR (D) Specifies that messages are written to the operator log. /OUTPUT[=file-spec] /OUTPUT=stdout (D) Specifies that the resulting information is written to the file file-spec .I f /OUTPUT or file-spec is omitted then the standard or default output is used. Related Commands • SHOW LOG Examples RTR> SET LOG/FIL[...]

  • Page 194

    SET MODE SET MODE Specify whether RTR should run in a group mode or the nogroup (system) mode. Format SET MODE Command Qualifiers Defaults /CLUSTER /NOCLUSTER /GROUP[=user-id] /NOGROUP /NODE=node-list /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The SET MODE command specifies whether RTR runs in group mode or nogroup mo[...]

  • Page 195

    SET MODE /NODE[=node-list] /NODE=default-node-list (D) Specifies that the command is executed on all nodes specified in node-list .I f node-list is omitted then the command is executed only on the node where the command was issued. /OUTPUT[=file-spec] /OUTPUT=stdout (D) Specifies that the resulting information is written to the file file-spec [...]

  • Page 196

    SET NODE SET NODE Sets various node related options. Format SET node Command Qualifiers Defaults /AUTOISOLA TE /NOAUTOISOLA TE /CLUSTER /NOCLUSTER /INACTIVITY_TIMEOUT[=secs] /INACTIVITY_TIMEOUT=60 /ISOLA TE /NOISOLA TE /NODE=node-list /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The SET NODE command sets the automatic is[...]

  • Page 197

    SET NODE /CLUSTER /NOCLUSTER (D) Specifies that the command is executed on all the nodes in the cluster . If neither /NODE nor /CLUSTER is specified then the command is executed on the nodes specified 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 comm[...]

  • Page 198

    SET P ARTITION SET P ARTITION Sets various partition related options. Format SET P ARTITION partition-name Command Qualifiers Defaults /F ACILITY=[facility_name] /F AILOVER_POLICY=[SHADOW | ST AND_BY] / /IGNORE_RECOVERY /NOIGNORE_RECOVER Y /PRIORITY_LIST=backend-node-list / /RECOVERY_RETR Y_COUNT=n / /REST ART_RECOVERY / /RESUME / /SHADOW /NOSHADO[...]

  • Page 199

    SET P ARTITION /IGNORE_RECOVER Y /NOIGNORE_RECOVER Y (D) Forces the partition to exit any current wait state it may be in. If a partition should enter a wait state or fail because of the unavailability of either a local or remote journal, this command can be used to override the default RTR behaviour . It instructs RTR to skip the current step in t[...]

  • Page 200

    SET P ARTITION Once shadowing is disabled, the secondary site servers will be unable to startup in shadow mode until shadowing is enabled again. Shadowing for the partition can be turned on by entering the command at the current active member or any of its standbys. If shadowing is already in the desired mode the command has no effect. /SUSPEND Sto[...]

  • Page 201

    SET TRANSACTION SET TRANSACTION Sets various transaction related options. Format SET TRANSACTION transaction-id Command Qualifiers Defaults /BEFORE[=date] today /ST A TE=current_state /F ACILITY=facility_name /RTR$DEF AUL T_F ACILITY (D) /NEW_ST A TE=new_state /NODE[=node_list /default_node_list /OUTPUT[=file-spec] /OUTPUT=stdout /P ARTITION=part[...]

  • Page 202

    SET TRANSACTION Usage Notes The command can only be executed on a backend node in which the journal is located and the RTR log file must be turned on to record the transaction changes. RTR needs to be started before using this command. When a transaction’ s state is changed, the new state is written to the RTR journal synchronously . RTR will tr[...]

  • Page 203

    SET TRANSACTION /NEW_ST A TE Specifies the new transaction state that selected transactions will be changed to. This qualifier is required and new state value must be specified. V alue of new_state may be one of the following: ABORT COMMIT DONE EXCEPTION Note that one cannot always change a transaction’ s state from one legitimate transaction [...]

  • Page 204

    SET TRANSACTION Examples RTR> SET TRANSACTION "50d01f10,0,0,0,0,2166,522b2001" - _RTR> /NEW=ABORT /CURRENT=SENDING /PART=DB_PART Abort this specified transaction running in the DB_P ART partition. RTR> SET TRANSACTION /NEW=ABORT /CURRENT=VOTED /PART=DB_PART For all transactions that are in VOTED transaction state and are running[...]

  • Page 205

    SHOW CHANNEL SHOW CHANNEL Show the names and state of channels that have been opened using the CLI API. Format SHOW CHANNEL [channel-name] Command Qualifiers Defaults /ALL_WINDOWS /NOALL_WINDOWS /CLUSTER /NOCLUSTER /NODE=node-list /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The SHOW CHANNEL command shows the channel typ[...]

  • Page 206

    SHOW CHANNEL Related Commands • call rtr_open_channel( ) • call rtr_close_channel( ) Examples RTR> SHOW CHANNEL/ALL_WINDOWS 1 Channel type Channel name (Owner pid) server RTR$DEFAULT_CHANNEL (28879) 2 client CLI_CHN (28879) 3 client CLI_CHN2 (26225) 4 1 Display information about all declared channels. 2 The channel called RTR$DEFAULT_CHANNEL[...]

  • Page 207

    SHOW CLIENT SHOW CLIENT Display information about client channels. Format SHOW CLIENT Command Qualifiers Defaults /CLUSTER /NOCLUSTER /F ACILITY /F ACILITY="*" /FULL none /IDENTIFICA TION=process-id /NOIDENTIFICA TION /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The SHOW CLIENT command display[...]

  • Page 208

    SHOW CLIENT /NODE[=node-list] /NODE=default-node-list (D) Specifies that the command is executed on all nodes specified in node-list .I f node-list is omitted then the command is executed only on the node where the command was issued. /OUTPUT[=file-spec] /OUTPUT=stdout (D) Specifies that the resulting information is written to the file file-sp[...]

  • Page 209

    SHOW DISPLA Y SHOW DISPLA Y Show which items were displayed by the most recently issued MONITOR command or DISPLAY commands. Format SHOW DISPLA Y Command Qualifiers Defaults /ALL /NOALL /OUTPUT[=file-spec] /OUTPUT=stdout /X=column /Y=row Description The SHOW DISPLAY command shows which items were displayed by the most recently issued MONITOR comm[...]

  • Page 210

    SHOW DISPLA Y Examples RTR> MON CALLS 1 RTR> SHOW DISPLAY/ALL 2 DISPLAY TEXT "RTR api calls, Node: $node_name ,- 3 PID: $process_id, Process name: -ALL-" - /X=1 /Y=1 - /BOLD="1" . . . DISPLAY NUMERIC "rtr_open_channel_succ" - /X=1 /Y=5 - /BLANK - /LABEL=" rtr_open_channel " - /WIDTH=9 . . . 1 Display th[...]

  • Page 211

    SHOW ENVIRONMENT SHOW ENVIRONMENT Shows the default nodes used for remote command execution. Format SHOW ENVIRONMENT Description The SHOW ENVIRONMENT command shows which nodes are used by default for remote command execution. Related Commands • SET ENVIRONMENT Examples RTR> SET ENVIRONMENT/NODE=(FE2,FE3) 1 RTR> SHOW ENVIRONMENT 2 %RTR-S-COM[...]

  • Page 212

    SHOW F ACILITY SHOW F ACILITY Show the names, configuration and status of one or more facilities. Format SHOW F ACILITY [facility-name] Command Qualifiers Defaults /BALANCE /NOBALANCE /CLUSTER /NOCLUSTER /CONFIGURA TION /NOCONFIGURA TION /COUNTER[=counter-name] /NOCOUNTER /FULL /NOFULL /LINKS /NOLINKS /ST A TE /NOST A TE /OUTPUT[=file-spec] /OUT[...]

  • Page 213

    SHOW F ACILITY /CONFIGURA TION /NOCONFIGURA TION (D) Specifies that the facility configuration is to be displayed. The configuration information indicates the role(s) of the the node where the command is executed, and Whether router call-out servers or backend call-out servers have been configured, Whether load balancing has been configured, W[...]

  • Page 214

    SHOW F ACILITY On a frontend, this qualifier can be used to find out whether the node is currently connected to a router . Related Commands • CREATE FACILITY • DELETE FACILITY • SHOW LINK Examples RTR> SHOW FACILITY/FULL/NODE=BRONZE 1 Facility: FUNDS_TRANSFER 2 Configuration:- 3 Frontend: no Router: yes Backend: yes Router call-out: no B[...]

  • Page 215

    SHOW F ACILITY 5 The facility’ s links. The first link shown (to node ‘‘bronze’ ’ i.e. itself) shows that it is a router , connected to the backend, and the router is quorate. The router is not current because there is no frontend on this connection. The link is also a backend, connected to the router , and this backend is quorate. This [...]

  • Page 216

    SHOW JOURNAL SHOW JOURNAL Display information about current RTR journal files. Format SHOW JOURNAL Command Qualifiers Defaults /CLUSTER /NOCLUSTER /FILENAMES /NOFILENAMES /FULL /NOFULL /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The SHOW JOURNAL command shows the disks where the RTR journal files res[...]

  • Page 217

    SHOW JOURNAL Related Commands • CREATE JOURNAL • DELETE JOURNAL • INITIALIZE JOURNAL Examples RTR> SHOW JOURNAL/FULL/FILENAMES 1 RTR journal:- 23 4 56 Disk(1): /dev/rz3a Blocks: 1500 Allocated: 1502 Maximum: 3000 File(1): /dev/rz3a /rtrjnl/SYSTEM/BRONZE.J01 7 Disk(2): /dev/rz2c Blocks: 1500 Allocated: 1502 Maximum: 3000 File(2): /dev/rz2c [...]

  • Page 218

    SHOW KEY SHOW KEY Display the key definitions created by the DEFINE /KEY command. Format SHOW KEY [key-name] Command Qualifiers Defaults /ALL /NOALL /FULL /NOFULL /OUTPUT[=file-spec] /OUTPUT=stdout /IF_ST A TE /NOIF_ST A TE Description The SHOW KEY command shows the key definitions created by the DEFINE /KEY command. Parameters key-name Speci?[...]

  • Page 219

    SHOW KEY Related Commands • DEFINE /KEY Examples RTR> SHOW KEY/FULL DEFAULT PF1 defined as "" DEFAULT KP0 defined as "MONITOR/RESUME" DEFAULT KP2 defined as "SCROLL DOWN 1" DEFAULT KP4 defined as "SCROLL LEFT 1" DEFAULT KP5 defined as "SCROLL HOME" DEFAULT KP6 defined as "SCROLL RIGHT 1&qu[...]

  • Page 220

    SHOW LINK SHOW LINK Display the configuration and status of the links to other nodes. Format SHOW LINK [node-name] Command Qualifiers Defaults /CLUSTER /NOCLUSTER /COUNTER[=counter-name] /NOCOUNTER /F ACILITY /NOF ACILITY /FULL /NOFULL /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout /ST A TE /NOST A TE Description Th[...]

  • Page 221

    SHOW LINK /FULL Equivalent to specifying /FACILITY/STATE . /NODE[=node-list] /NODE=default-node-list (D) Specifies that the command is executed on all nodes specified in node-list .I f node-list is omitted then the command is executed only on the node where the command was issued. /OUTPUT[=file-spec] /OUTPUT=stdout (D) Specifies that the result[...]

  • Page 222

    SHOW LOG SHOW LOG Display the names of the current log files. Format SHOW LOG Command Qualifiers Defaults /CLUSTER /NOCLUSTER /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The SHOW LOG command shows the names of the current RTR log files as defined with the SET LOG command. Qualifiers /CLUSTER /NOCLU[...]

  • Page 223

    SHOW LOG Example RTR> SHOW LOG 1 Messages not being sent to operator console 2 Log file[1]: /usr/users/someone/rtr_logfile.log 3 1 Show where RTR log messages are currently written. 2 Currently not being sent to the operator log. 3 Currently being written to file rtr_logfile.log . RTR Command Line Interface 6–147[...]

  • Page 224

    SHOW MODE SHOW MODE Displays the current RTR mode. Format SHOW MODE Command Qualifiers Defaults /CLUSTER /NOCLUSTER /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The SHOW MODE command shows the currently running user group for RTR. For nogroup (system) mode, a null group name is displayed. SET MODE comma[...]

  • Page 225

    SHOW MODE Examples RTR> SHOW MODE Group name is "develop" RTR Command Line Interface 6–149[...]

  • Page 226

    SHOW NODE SHOW NODE Shows the node network status, the autoisolation state and the node inactivity timer . Format SHOW NODE Command Qualifiers Defaults /CLUSTER /NOCLUSTER /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The SHOW NODE shows the network status, the autoisolation state (enabled or disabled) a[...]

  • Page 227

    SHOW NODE Examples RTR> SHOW NODE 1 Node properties: Network state: enabled 2 Auto isolation: disabled 3 Inactivity timer/s: 60 4 1 SHOW NODE command. 2 Network status 3 Auto isolation state (enabled or disabled). 4 Inactivity timer value in seconds. RTR Command Line Interface 6–151[...]

  • Page 228

    SHOW P ARTITION SHOW P ARTITION Display server data partition information. Format SHOW P ARTITION Command Qualifiers Defaults /BACKEND /BACKEND /BRIEF /NOBRIEF /CLUSTER /NOCLUSTER /F ACILITY /F ACILITY="*" /FULL /NOFULL /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout /ROUTER /ROUTER Description The SHOW PART[...]

  • Page 229

    SHOW P ARTITION T able 6–21 Router Partition States State Meaning BLOCKED Key range is recovering or awaiting journal access ACTIVE Primary server is ready to accept transactions CA TCHUP Secondary server is catching up with primary T AKEOVR Standby take-over is in progress LAGGING Secondary is ready , primary is still recovering Qualifiers /BAC[...]

  • Page 230

    SHOW P ARTITION • The state of transaction presentation - one of active, suspended or suspending • The current failover policy - one of fail_to_standby , fail_to_shadow or pre_ v32_compatibilty The SHOW P ARTITION comand displays callout server data as backend server data because a callout server uses server , not router , data structures. A ca[...]

  • Page 231

    SHOW P ARTITION Partition name: RTR$DEFAULT_PARTITION_16777217 Facility: RTR$DEFAULT_FACILITY State: active Low Bound: "aaaa" High Bound: "mmmm" Active Servers: 0 Free Servers: 1 Transaction presentation: active Last Rcvy BE: Txns Active: 0 Txns Rcvrd: 0 Failover policy: fail_to_standby Key range ID: 16777217 Partition name: RTR[...]

  • Page 232

    SHOW PROCESS SHOW PROCESS Display information about processes which are using RTR. Format SHOW PROCESS Command Qualifiers Defaults /CLUSTER /NOCLUSTER /COUNTER[=counter-name] /NOCOUNTER /FULL /NOFULL /IDENTIFICA TION=process-id /NOIDENTIFICA TION /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The SHOW PRO[...]

  • Page 233

    SHOW PROCESS /OUTPUT[=file-spec] /OUTPUT=stdout (D) Specifies that the resulting information is written to the file file-spec .I f /OUTPUT or file-spec is omitted then the standard or default output is used. Examples RTR> SHOW PROCESS Processes: Process-id Process Name 326 RTR Command Line Interface 6–157[...]

  • Page 234

    SHOW REQUESTER SHOW REQUESTER See SHOW CLIENT . The SHOW REQUESTER command has been replaced by SHOW CLIENT and is retained for compatibility reasons only . 6–158 RTR Command Line Interface[...]

  • Page 235

    SHOW RESOURCE MANAGER (SHOW RM) SHOW RESOURCE MANAGER (SHOW RM) Displays resource manager instance (RM) information. This command is available only on UNIX and W indows NT systems. Format SHOW RESOURCE MANAGER [resource_name] SHOW RM [resource_name] Command Qualifiers Defaults /CLUSTER /NOCLUSTER /FULL /NOFULL /NODE[=node-list] /NODE=default-node-[...]

  • Page 236

    SHOW RESOURCE MANAGER (SHOW RM) /FULL /NOFULL (D) Displays additional information for facilities that reference a particular RM. If no rmi_name is included, displays information for all RMs. /NODE[=node-list] /NODE=default-node-list (D) Specifies that the command is executed on all nodes specified in node-list .I f node-list is omitted then the c[...]

  • Page 237

    SHOW RTR SHOW RTR Display the configuration and status of RTR. Format SHOW RTR Command Qualifiers Defaults /CLUSTER /NOCLUSTER /COUNTER[=counter-name] /NOCOUNTER /FULL /NOFULL /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout /ST A TUS /NOST A TUS /VERSION /NOVERSION Description The SHOW RTR command displays the confi[...]

  • Page 238

    SHOW RTR /ST A TUS (D) /NOST A TUS Displays the current status of RTR (started, stopped and so on). /VERSION /NOVERSION (D) Displays the RTR version. Related Commands • STOP RTR • START RTR Example RTR> SHOW RTR 1 RTR running on node baby.home.dec.com in group: develpr 2 1 Show the state and configuration of RTR. 2 RTR has been started in g[...]

  • Page 239

    SHOW SEGMENT SHOW SEGMENT Display the type and size of routing key segments. Format SHOW SEGMENT Command Qualifiers Defaults /CLUSTER /NOCLUSTER /F ACILITY /F ACILITY="*" /FULL /NOFULL /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The SHOW SEGMENT command displays the routing key segment defin[...]

  • Page 240

    SHOW SEGMENT Examples RTR> SHOW SEGMENT 1 Facility Data Type Length Offset RTR$DEFAULT_FACILITY UNSIGNED 1 0 2 TEST_FAC SIGNED 4 10 1 Show the routing key segments for all facilities. 2 The facility name, the routing key data type, key length and offset are shown for each facility . 6–164 RTR Command Line Interface[...]

  • Page 241

    SHOW SERVER SHOW SER VER Display information about server channels. Format SHOW SERVER Command Qualifiers Defaults /CLUSTER /NOCLUSTER /F ACILITY /F ACILITY="*" /FULL /NOFULL /IDENTIFICA TION=process-id /NOIDENTIFICA TION /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The SHOW SERVER command dis[...]

  • Page 242

    SHOW SERVER T able 6–23 Server Flags FLAG Meaning BEC Backend Call-out EXA Explicit Accept EXP Explicit Prepare NCC No Concurrent NSB No Standby SHD Shadow SR V Server TRC Router Call-out Qualifiers /CLUSTER /NOCLUSTER (D) Specifies that the command is executed on all the nodes in the cluster . If neither /NODE nor /CLUSTER is specified then t[...]

  • Page 243

    SHOW SERVER Examples RTR> SHOW SERVER Servers: Process-id Facility Channel Flags State 20828 RTR$DEFAULT_FACILITY 589825 SRV active 20828 RTR$DEFAULT_FACILITY 655362 SRV active RTR> SHOW SERVER/FULL Servers: Process-id: 20828 Facility: RTR$DEFAULT_FACILITY Channel: 589825 Flags: SRV State: active Low Bound: aaaa High Bo mmmm rcpnam: "LOW[...]

  • Page 244

    SHOW TRANSACTION SHOW TRANSACTION Displays information about currently active transactions. Format SHOW TRANSACTION Command Qualifiers Defaults /BACKEND /NOBACKEND (D) /CLUSTER /NOCLUSTER /F ACILITY /F ACILITY="*" /FRONTEND /NOFRONTEND (D) /FULL /NOFULL /IDENTIFICA TION=process-id /NOIDENTIFICA TION /NODE[=node-lisft] /NODE=default-node-[...]

  • Page 245

    SHOW TRANSACTION Note: In environments that do not support clustering, use of the /CLUSTER qualifier will cause the relevant command to be executed on the local node only . /FRONTEND /NOFRONTEND (D) Specifies that information should be listed for transactions in a frontend node. If none of /BACKEND, /FRONTEND or /ROUTER are specified, then infor[...]

  • Page 246

    SHOW TRANSACTION T able 6–25 (Cont.) Key-Range States State Meaning active Active non-shadowed sec_act Secondary active pri_act Primary active pri_lone Primary running alone sec_chup Secondary is catching up Examples RTR> SHOW TRANSACTION/BACKEND/FULL Backend transactions: Tid: e100b810,0,0,0,0,a85,83290001 Facility: RTR$DEFAULT_FACILITY Front[...]

  • Page 247

    SP A WN SP A WN Allows you to execute operating system commands without leaving the RTR utility . Format SP AWN [operating-system-command] Command Qualifiers Defaults /INPUT=file-spec /NOINPUT /OUTPUT=file-spec /OUTPUT=stdout /W AIT /W AIT Description The SPAWN command allows you to execute operating system commands without leaving the RTR sessi[...]

  • Page 248

    ST ART RTR ST ART RTR Start RTR on one or more nodes. Format ST ART R TR Command Qualifiers Defaults /CLUSTER /NOCLUSTER /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout The following qualifiers are only relevant when running on OpenVMS. Command Qualifiers Defaults /ASTLM=ast-limit Dependent on /LINKS and /PROCESSES [...]

  • Page 249

    ST ART RTR Qualifiers /ASTLM=ast-limit /ASTLM=(max-links + max-processes) 2 + 10 = default ast-limit (D) Specifies the AST limit for the RTR ACP . The value for ast-limit must include five for RTR ACP mailbox reads and timer scheduling and a minimum of two per DECNET logical link maintained by RTR. For example, in a 20-node configuration, a rou[...]

  • Page 250

    ST ART RTR /DIOLM=io-direct /DIOLM=(max-links + max-processes) 2 + 10 = default io-direct (D) Specifies the maximum number of direct I/O operations that the RTR ACP can have outstanding at any one time. If you do not specify a direct I/O quota, the default value established at system generation time is used. The default for io-direct is automatica[...]

  • Page 251

    ST ART RTR The default value of page-file is automatically calculated, based on the values of /LINKS and /PROCESSES. /PRCLM=subprocess-limit /PRCLM=10 (D) Specifies the maximum number of subprocesses that the RTR ACP can create. The default for subprocess-limit is 10. /PRIORITY=priority /PRIORITY=6 (D) Requires alter priority (AL TPRI) privilege t[...]

  • Page 252

    ST ART RTR Related Commands • SHOW RTR • STOP RTR Examples See Chapter 2, Starting and Setting Up RTR, for examples of how to use the START RTR command. 6–176 RTR Command Line Interface[...]

  • Page 253

    STOP RTR ST OP RTR Stop RTR on one or more nodes. Format STOP R TR Command Qualifiers Defaults /ABORT /NOABOR T /CLUSTER /NOCLUSTER /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout Description The STOP RTR command stops RTR in an orderly manner . Alternatively , RTR can be stopped in an abrupt manner (/ABORT), and any [...]

  • Page 254

    STOP RTR /OUTPUT[=file-spec] /OUTPUT=stdout (D) Specifies that the resulting information is written to the file file-spec .I f /OUTPUT or file-spec is omitted then the standard or default output is used. Related Commands • SHOW RTR • START RTR Examples See Chapter 2, Starting and Setting Up RTR, for examples of how to use the STOP RTR comman[...]

  • Page 255

    TRIM F ACILITY TRIM F ACILITY Removes nodes or roles or both from an existing facility definition. Format TRIM F ACILITY [facility_name] Command Qualifiers Defaults /BACKEND=backend-list /NOBACKEND /CLUSTER /NOCLUSTER /FRONTEND=frontend-list /NOFRONTEND /NODE[=node-list] /NODE=default-node-list /OUTPUT[=file-spec] /OUTPUT=stdout /ROUTER=router-l[...]

  • Page 256

    TRIM F ACILITY RTR MONITOR QUORUM displays a monitor picture which allows the quorum negotiations to be observed. Y ou can use this after using a TRIM F ACILITY command; once quorum has been re-attained, the participating nodes return to the quorate state. For example, in a three node facility called facnam , the nodes FE and NFE have only frontend[...]

  • Page 257

    TRIM F ACILITY /NOFRONTEND (D) Specifies the names of nodes where the frontend role is removed for this facility . frontend-list is a list of frontend-nodes separated by commas. If there is more than one frontend-node , then frontend-list must be enclosed in parentheses. frontend-node is either the name of a node or @file-spec , where file-spec sp[...]

  • Page 258

    UNREGISTER RESOURCE MANAGER (UNREGISTER RM) UNREGISTER RESOURCE MANAGER (UNREGISTER RM) The UNREGISTER RESOURCE MANAGER command unregisters an instance of a resource manager . Format UNREGISTER RESOURCE MANAGER [resource_name] UNREGISTER RM [resource_name] Command Qualifiers Defaults /CLUSTER /NOCLUSTER /NODE[=node-list] /NODE=default-node-list /O[...]

  • Page 259

    A Creating Monitor Pictures The standard monitor pictures provided with RTR (described in Chapter 5) are sufficient for most needs. Y ou may also create your own monitor pictures to suit particular needs. This appendix tells you how to do this. The RTR monitor utility provides a means to continuously display the status of RTR and the applications [...]

  • Page 260

    Creating Monitor Pictures The commands used to define and display monitor pictures are: CLEAR DISPLA Y BAR DISPLA Y NUMERIC DISPLA Y STRING DISPLA Y SYMBOLIC DISPLA Y TEXT MONITOR SCROLL SHOW DISPLA Y These commands are described in the following sections. A.1 Interactive Definition of a Monitor Picture Example A–1 shows a monitor picture being[...]

  • Page 261

    Creating Monitor Pictures A.1 Interactive Definition of a Monitor Picture Figure A–1 Interactively Defined Monitor Picture THE TEST PICTURE AT 11:49:24 SOME DATA ITEM: 0 OTHER DATA ITEM: 0 Caution Because monitor file definitions depend on the internal structure and data items of RTR, they may need to be changed for future versions of RTR. A.[...]

  • Page 262

    Creating Monitor Pictures A.3 Arithmetic Expressions and Operators T able A–3 Arithmetic Operators in Display Commands Characters Meaning - Minus + Plus * Multiply / Divide & Logical AND | Logical OR <= Less than or equal >= Greater than or equal != Not equal <> Not equal < Less than > Greater than = Equal Example A–2 show[...]

  • Page 263

    Creating Monitor Pictures A.3 Arithmetic Expressions and Operators Aggregation of Data Items DISPLA Y commands which select multiple instances of a data item (for example, multiple instances of a process counter) can use the following keywords to control the way the items are aggregated. _MIN—select the data item instance with the lowest value _M[...]

  • Page 264

    [...]

  • Page 265

    B Server Shadowing and Recovery RTR shadowing gives you the ability to recover from a site disaster without the need for special coding within your application program. This appendix is an introduction to RTR shadowing. A server for a database partition is said to be shadowed when two copies of the same server perform identical actions on identical[...]

  • Page 266

    Server Shadowing and Recovery B.2 Automatic Features • RTR_EVTNUM_SRSHADOWGAIN - Server has gained its shadow partner • RTR_EVTNUM_SRRECOVERCMPL - Server has completed recovery The shadow events are delivered with no special status and no data. They are delivered only to the server(s) whose state has changed. A server receives RTR_EVTNUM_SRPRIM[...]

  • Page 267

    Server Shadowing and Recovery B.3 The RTR Journal System The number of blocks specified by the /BLOCKS qualifier specifies the size of the journal that RTR attempts to keep to. (The actual number of blocks used may vary , depending upon the load on RTR.) The command MODIFY JOURNAL also accepts the /BLOCKS and /MAXIMUM_ BLOCKS qualifiers. Journa[...]

  • Page 268

    Server Shadowing and Recovery B.4 Shadow Site Failure and Journaling B.4.1 Maximum Journal Size The current maxima for the size of a journal are: Number of blocks per disk: 524288 (This is max_segments_per_disk * disk_blocks_per_segment , or 16384 times 32.) Number of disks per journal: 16. B.5 Standby for Shadows Shadowed sites can either be two n[...]

  • Page 269

    Server Shadowing and Recovery B.6 Performance Note that RTR does not have to wait for the secondary shadow server to complete its processing. It only needs to know that the primary has committed the transaction and that the journal file of the secondary shadow server contains the final vote status. The two partners in a shadow pair should be conn[...]

  • Page 270

    Server Shadowing and Recovery B.8 Application Considerations • Any physical reference to the transaction which is unique to the executing server , e.g. Channel Id, system time, DB-key , etc., should not be passed back to the client for future references within its subsequent messages, as this could lead to inconsistent handling when a different s[...]

  • Page 271

    Server Shadowing and Recovery B.9 Server States Figure B–2 Server States WAIT−TR−OK WAIT−TR−RETRY Retry Router detects definition clash Propose KR to Routers Error Proposal accepted − commit KR ACTIVE REMEMBER CATCHUP WAIT CATCHUP SECONDARY WAIT−JNL WAIT RESTART RESTART Router sends list of recovery Journals STANDBY SECONDARY STANDBY [...]

  • Page 272

    Server Shadowing and Recovery B.10 Client States B.10 Client States The current state of a client process can be examined as follows: RTR> show client/full Clients: Process-id: 13340 Facility: RTR$DEFAULT_FACILITY Channel: 458755 Flags: CLI State: declared rcpnam: "CHAN3" User Events: 255 RTR Events: 0 Figure B–3 describes the client[...]

  • Page 273

    Server Shadowing and Recovery B.1 1 Partition States B.1 1 Partition States The current state of a key-range partition can be examined using the SHOW PARTITION/FULL command for the routers and the backends: RTR> show partition/router/full Facility: RTR$DEFAULT_FACILITY State: ACTIVE Low Bound: 0 High Bound: 4294967295 Failover policy: fail_to_st[...]

  • Page 274

    [...]

  • Page 275

    C XA Support This appendix explains how RTR may be used with a X/OPEN Distributed T ransaction Processing (DTP) conformant Resource Manager . C.1 Introduction The X/OPEN Distributed T ransaction Processing (DTP) architecture defines a standard interface that lets application programs share resources provided by resource managers. The XA interface [...]

  • Page 276

    XA Support C.1 Introduction facility_name = user-specified facility name /resource_manager = the name of those RMs this facility references For example: CREATE FACILITY test /front=N1 /back=N2/router=N3 /resource_manager=(employ_rm,payroll_rm) C.1.3 Modified RTR API An application written to use RTR with XA does not need all existing RTR applicat[...]

  • Page 277

    D RTR Utility Error Messages This appendix describes the various error messages that can be returned by the RTR utility . %RTR-F-ABKEYW , Ambiguous qualifier or keyword - supply more characters Explanation: T oo few characters were used to truncate a keyword or qualifier name to make the keyword or qualifier name unique. %RTR-F-ABVERB, Ambiguous[...]

  • Page 278

    RTR Utility Error Messages %RTR-F-BADDSKWRI, Unable to create/extend a journal file Explanation: An attempt to create or extend a journal file on disk failed. Check that the disk(s) you are using for journals have sufficient free space. %RTR-E-BADOP , Unable to complete operation @[A] line [A] Explanation: Processing definition incomplete or un[...]

  • Page 279

    RTR Utility Error Messages %RTR-E-CLOSEPEND, Send failed due to close pending on channel - call rtr_ receive_message Explanation: Sending of data to the ACP has been aborted due to the presence of an undelivered mt_closed message on the channel. The application may retrieve the reason for the channel closure, by calling the receive_message verb to [...]

  • Page 280

    RTR Utility Error Messages %RTR-S-DISITMCLR, [A] display item(s) cleared Explanation: Indicates how many display items [A] were successfully cleared after issuing a CLEAR DISPLA Y command. %RTR-W -DISKALL, Disk is not available to RTR Explanation: An attempt was made to create a journal on a disk which is allocated to a different process. %RTR-W -D[...]

  • Page 281

    RTR Utility Error Messages %RTR-F-DUPJOUFIL, Duplicate RTR journal file found - remove duplicate file or CREA TE JOURNAL /SUPERSEDE Explanation: A duplicate RTR journal file has been found. This status may be returned by the CREA TE F ACILITY and SHOW JOURNAL commands. Probable cause: System management error . A user has copied a journal file, [...]

  • Page 282

    RTR Utility Error Messages %RTR-F-ERRACCDIR, Directory [A], cannot be accessed or opened Explanation: A directory cannot be accessed or opened. %RTR-E-ERRACCFIL, Error accessing file [A] Explanation: Displays the name [A] of a file that the RTR utility was unable to access. %RTR-E-ERRACCMBX, Error accessing mailbox Explanation: An error occurred [...]

  • Page 283

    RTR Utility Error Messages %RTR-E-ERRST AACP , Unable to start ACP Explanation: The RTR ACP process could not be started when a "ST ART RTR" command was issued. The subsequent message gives more details. %RTR-E-ERRST ARCH, Unable to start remote client handler Explanation: The RTR remote client handler process could not be started when a [...]

  • Page 284

    RTR Utility Error Messages %RTR-E-F ACNAMLON, Facility name [A] is longer than 30 characters Explanation: Facility name [A] is too long. %RTR-E-F ACNAMST A, Facility name [A] does not start with a letter Explanation: Facility name [A] does not start with a capital letter ("A" to "Z"). %RTR-E-F ACT ABFUL, The F AC table is full E[...]

  • Page 285

    RTR Utility Error Messages %RTR-E-ILLP ARTCHAR, Legal characters are alphanumeric and under-score Explanation: Illegal chars in partition name argument. %RTR-E-ILLREMDEV , Device [A] contains a node specification Explanation: RTR cannot create its journal files on remote systems. Re-issue the "CREA TE JOURNAL" command for local disk. %R[...]

  • Page 286

    RTR Utility Error Messages %RTR-F-INVKSTYPE, Invalid ks_type argument Explanation: Invalid ks_type argument. %RTR-F-INVMSGFMT , Invalid format argument Explanation: Invalid format argument. Possible reasons include the use of an invalid character or expression in the format string, or a mismatch in the number of bytes specified by the format strin[...]

  • Page 287

    RTR Utility Error Messages %RTR-E-ITMALREXI, There is already something displayed at x = [A], y = [A] Explanation: Indicates that invalid coordinates were specified on a "DISPLA Y" command within a display file. There already is an item at point [A], [B]. %RTR-F-IVKEYW , Unrecognized keyword - check validity and spelling n [A] Explanati[...]

  • Page 288

    RTR Utility Error Messages %RTR-F-JOUFORCHA, Journal format has been changed - CREA TE JOURNAL /SUPERSEDE Explanation: The journal file(s) found have an out-of-date format. This status may be returned by the CREA TE F ACILITY and SHOW JOURNAL commands after a new version of RTR has been installed on a system. Corrective action: Issue an RTR CREA T[...]

  • Page 289

    RTR Utility Error Messages %RTR-S-JOURNALINI, Journal has been created on device [A] Explanation: Confirms that the RTR journal has been successfully created on device [A] after issuing the "CREA TE JOURNAL" command. %RTR-S-JOURNALMOD, Journal has been modified on device [A] Explanation: Confirms that the RTR journal has successfully m[...]

  • Page 290

    RTR Utility Error Messages %RTR-E-LOCKF AIL, Cannot obtain lock for resource [A] Explanation: Failed to obtain lock. Enable logging for more information about error . %RTR-S-LOGFILSET , Logging to [A] Explanation: Displays which log files will be used after issuing a "SET LOG" command with the "/FILE" or "/OPERA TOR" [...]

  • Page 291

    RTR Utility Error Messages %RTR-E-NDBT ABFUL, The NDB table is full Explanation: This message is displayed when an "CREA TE F ACILITY" command is issued. It indicates that the total number of different nodes specified with this and all previous "CREA TE F ACILITY" commands would exceed the limit specified with the "/LINKS[...]

  • Page 292

    RTR Utility Error Messages %RTR-E-NODNA, DECnet specified for [A], but transport protocol unavailable or disabled Explanation: DECnet was specified as required through use of a node name prefix ("dna." or a substitute), but no corresponding entry in the node database can be found. Add an entry for the indicated node to your local node [...]

  • Page 293

    RTR Utility Error Messages %RTR-E-NOKEYSEGS, Y ou must specify at least one keysegment - use /KEY1 - /KEY9 Explanation: Except for a callout partition, it is necessary to define the key range, so the absence of any key segment descriptors is an error . %RTR-F-NOKEYW , Qualifier name is missing - append the name to the slash Explanation: A slash c[...]

  • Page 294

    RTR Utility Error Messages %RTR-E-NOSUCHITM, Nothing displayed at x = [A] ,y=[ A ] Explanation: Indicates that invalid coordinates were specified on a "CLEAR DISPLA Y" or "SHOW DISPLA Y" command. No item is displayed at point [A], [B]. %RTR-E-NOSUCHNOD, No such node, [A] Explanation: The requested node [A] does not exist. %RTR-[...]

  • Page 295

    RTR Utility Error Messages %RTR-E-NUMCONILL, Numeric constant has illegal syntax, [A] Explanation: The numeric constant [A] is invalid. %RTR-W -OBSQUAL, Qualifier [A] is obsolete - value ignored Explanation: An obsolete qualifier has been specified on a command line. The qualifier no longer has any effect, and the specified value will be ignor[...]

  • Page 296

    RTR Utility Error Messages %RTR-E-PRTBADCMD, Partition command invalid or not implemented in this version of RTR Explanation: Status return indicating that the ACP received a request for an unknown partition command. %RTR-E-PRTBADFPOL, Unrecognised partition failover policy code Explanation: Status indicating that an invalid value was specified fo[...]

  • Page 297

    RTR Utility Error Messages %RTR-S-PRTNCREA TED, Partition created Explanation: The requested partition was successfully created. %RTR-S-PRTNDELETED, Partition deleted Explanation: The requested partition was successfully deleted. %RTR-S-PRTNEWFPOLS, Failover policy set Explanation: Status indicating successful change to the partition failover polic[...]

  • Page 298

    RTR Utility Error Messages %RTR-E-PRTRUNDOWN, Partition is in rundown prior to deletion - no action taken Explanation: Cannot perform the requested action since the partition is being deleted. %RTR-I-PRTSHDOFF , Partition [A]:[A] shadow state set to off by operator [A] Explanation: W ritten to log file in response to a user request to change the s[...]

  • Page 299

    RTR Utility Error Messages %RTR-E-RTRALRST A, RTR already started Explanation: RTR was already running when the "ST ART RTR" command was executed. %RTR-S-RTRLOGENT , [A] Explanation: The RTR LOG command was used to make an entry in the RTR LOG %RTR-I-RTRNOTRUN, RTR not running Explanation: Message created specifically for the STOP RTR co[...]

  • Page 300

    RTR Utility Error Messages %RTR-F-SPUJOUFIL, Spurious RTR journal file found - remove extra file, or CREA TE JOURNAL /SUPERSEDE and submit SPR Explanation: A spurious RTR journal file has been found which does not correspond to the other journal files on the system. This status may be returned by the CREA TE F ACILITY and SHOW JOURNAL commands.[...]

  • Page 301

    RTR Utility Error Messages %RTR-E-TOOMANCHN, T oo many channels Explanation: Displayed when a "SYS$DCL_TX_PRC" command is issued and the channel table is full. %RTR-F-TOOMANDIS, T oo many disks specified in journal definition Explanation: Explanation: T oo many disks were specified in journal definition. The RTR journal can be define[...]

  • Page 302

    RTR Utility Error Messages %RTR-E-UNEXPEND, Expression ended before [A] encountered Explanation: The expression is invalid because it terminated where when token [A] was expected. %RTR-E-UNKNOWQUAL, Invalid qualifier keyword value - check your program Explanation: Status return indicating that an unrecognised qualifier keyword value was supplied.[...]

  • Page 303

    E RTR log messages This appendix describes the various error messages that can be sent to the operator console or written to RTR’ s operator log file. %RTR-E-ABODEAREQ, T ransaction aborted that was started by client that has since exited Explanation: Indicates that a transaction has been aborted that was started by a client that has since exite[...]

  • Page 304

    RTR log messages %RTR-E-BADIDSIZ, Bad node ID size [A] detected at 0x[A] Explanation: This message indicates that errors have been detected in processing of an internal node identifier . The presence of this message indicates a serious problem in the configuration of the network name/address databases, and RTR will likely be unable to operate cor[...]

  • Page 305

    RTR log messages %RTR-F-BRODISLIN, Broadcast message(s) discarded because of link unavailability Explanation: One or more broadcast messages had to be discarded because there is no logical link to the destination node. %RTR-I-CLUENABLED, RTR cluster [A] is enabled using [A] Explanation: Information message indicating whether RTR is making use of an[...]

  • Page 306

    RTR log messages %RTR-I-CONNALIAS, Link [A] connected as [A] Explanation: Support for internet tunnels allows for the configuration of links from which connections appear to originate with an source address other than that by which the local node is registered locally , for example, the connection may appear to originate from an pseudo-adapter add[...]

  • Page 307

    RTR log messages %RTR-I-F ACLOSTFE, Facility [A] lost Frontend node [A] Explanation: This node is no longer a current router on facility [A], for frontend node [B] %RTR-I-F ACLOSTTR, Facility [A] lost Router node [A] Explanation: A connection has been lost with router node [B] on facility [A] %RTR-E-F ACNOTDEC, Facility name not matched Explanation[...]

  • Page 308

    RTR log messages full). RTR has ensured that the TX has been committed, but the operator should nevertheless check the condition on the BE where the TX was aborted to determine why this occurred (possible resource problems on the server , for example). %RTR-F-INCOMP A T , Incompatible RTR versions Explanation: Attempt to start up an incompatible ve[...]

  • Page 309

    RTR log messages %RTR-I-JOUSEACOM, Journal search on facility [A] completed. [A] recoverable transactions found Explanation: Journal search has completed. This message appears when RTR is started The number of transactions needing recovery is indicated by [A]. %RTR-F-JOUSEQERR, RTR journal record sequence error - CREA TE JOURNAL /SUPERSEDE and subm[...]

  • Page 310

    RTR log messages %RTR-E-NOCURRTR, Current router search failed for facility [A] Explanation: None of the routers specified for facility [A] are currently connectable. The search will continue after a short interval. %RTR-W -NODENOTCNFG, Node is not configured for the facility Explanation: Result of a connection attempt to a remote node where the [...]

  • Page 311

    RTR log messages %RTR-I-PRTCMDFRMBE, Command received for partition [A]:[A] from backend node [A] Explanation: Log file message indicating the origin of a command. %RTR-E-PRTDELCAN, Partition deleted - operation canceled Explanation: Status used to terminate a pending operation when the partition is deleted prior to completion of the operation. %R[...]

  • Page 312

    RTR log messages %RTR-E-PRTSETF AIL TR, Router unable to process command Explanation: A partition set command failed at the router . An entry is written to the log file describing the problem. Message arguments are the facility name and the KR ID. A second message is written detailing the nature of the problem. %RTR-W -PRTSHDRECEXIT , Partition [A[...]

  • Page 313

    RTR log messages %RTR-F-QIROVERFLOW , No more QIRs left Explanation: This status is used to indicate an inadequacy in the static reservations for the internal query initiation descriptors. Make a note of all QRM counters using SHOW RTR /COUNTER=QRM* Send SPR with the corresponding RTRACP dump. %RTR-F-RAEOVERFLOW , No more RAEs Explanation: This sta[...]

  • Page 314

    RTR log messages %RTR-W -RSPF AC, Response from Node [A] about Facility [A] Explanation: A negotiation with remote node [A] about facility [B] has failed for the reason reported in the following line. This may be a reason for system manager intervention. %RTR-W -RSPNODE, Connection to node [A] failed : reason is Explanation: A negotiation with remo[...]

  • Page 315

    RTR log messages %RTR-W -TOOMANYNETIDS, T oo many net IDs for node ’[A]’ - check for and eliminate any unnecessary adapter/protocol combinations Explanation: On a system configured to run multiple network protocols over multiple adpaters, RTR can run out of space to store and communicate the resultant node IDs. Y ou may be able to operate unde[...]

  • Page 316

    [...]

  • Page 317

    Index A Active Monitor, 5–2 Aggregation of Data Items, A–5 B Backend, 2–1 BAR DISPLA Y, 6–67 Broadcast Monitor, 5–2 C Call Rtr_accept_tx, 6–3 rtr_prepare_tx, 6–22 CALL RTR_BROADCAST_EVENT, 6–6 RTR_CLOSE_CHANNEL, 6–10 RTR_ERROR_TEXT, 6–12 RTR_GET_TID, 6–13 RTR_OPEN_CHANNEL, 6–15 RTR_RECEIVE_MESSAGE, 6–25 RTR_REJECT_TX, 6–[...]

  • Page 318

    DTC Support, C–2 E ENVIRONMENT SET, 1–4, 6–108 SHOW, 6–135 Errors, 1–2 Event Monitor, 5–2 EXECUTE, 6–89 EXIT, 6–90 EXTEND F ACILITY, 6–91 F Facility, 1–1 Create, 2–1 Monitor, 5–2 F ACILITY CREA TE, 6–47 DELETE, 2–4, 6–61 EXTEND, 6–91 SET, 6–109 SHOW, 6–136 TRIM, 6–179 @file, 1–3 Flow Monitor, 5–2 FLUSH NAM[...]

  • Page 319

    Monitor (cont’d) Routing, 5–3 Rtr, 5–3 Stalls, 5–3 System, 5–3 Tps, 5–3 Tpslo, 5–3 T raffic, 5–3 V2calls, 5–4 XA, 5–4 MONITOR, 5–1, 6–100 Monitor file, 5–1 Monitor picture, 5–1, A–1 N NAME_CACHE FLUSH, 6–88 Netbytes Monitor, 5–3 Netstat Monitor, 5–3 Network transports, 2–13 NODE SET, 6–120 SHOW, 6–150 NUM[...]

  • Page 320

    SET (cont’d) MODE, 6–1 18 NODE, 6–120 P ARTITION, 6–122 TRANSACTION, 6–125 SHOW CHANNEL, 6–129 CLIENT, 6–131 DISPLA Y, 6–133, A–2 ENVIRONMENT, 6–135 F ACILITY, 6–136 JOURNAL, 6–140 KEY, 6–142 LINK, 6–144 LOG, 6–146 MODE, 6–148 NODE, 6–150 P ARTITION, 6–152 PROCESS, 6–156 REQUESTER, 6–158 RESOURCE MANAGER, 6?[...]