Reliable Transaction Router
System Manager's Manual


Previous Contents Index

6.2.2 Monitor Acp2app


RTR ACP to Application Messages, Node: NodeA  PID: -ALL-   Process name: -ALL- 
    Image: -ALL-                                      14:15:46 Mon Jan 25 1999 
Message Type        Client               Server             Other         Pend 
                    #      Bytes         #     Bytes        #      Bytes     # 
opened              0          0         0         0        0          0     0 
closed              0          0         0         0        0          0     0 
msg1                                     0         0                         0 
msg1_uncertain                           0         0                         0 
msgn                                     0         0                         0 
reply               0          0                                             0 
rettosend           0          0                                             0 
prepared            0          0                                             0 
accepted            0          0         0         0                         0 
rejected            0          0         0         0                         0 
user_event          0          0         0         0                         0 
rtr_event           0          0         0         0                         0 
prepare                                                     0          0     0 
                    other 
request_info                                                0          0     0 
set_info                                                    0          0     0 
                  calls   active     fail   timeout 
receive_message       0        0        0         0 
user_wakeup           0        0 

Displays counts of messages and number of bytes from RTRACP to the application, as viewed from a specific node. Includes opened, closed, msg1, msg1_uncertain, msgn, reply (reply to client), rettosend (return to sender), accepted, prepared, rejected, user_event, rtr_event, prepare, request_info , and set_info messages as appropriate. For receive_message and user_wakeup , displays calls, active, fail, and timeout counts. Refer to the C Application Programmer's Reference Manual for an explanation of the message types.

The default is to display information on all PIDs, process names, and images. To display information on one process only, use the qualifier /IDENTIFICATION= process-id .

6.2.3 Monitor Active


 
ACTIVE TRANSACTIONS BY PROCESS  Fri Mar 12 1999 19:32:41 
 
                                              Starts  Complete  Active 
Display totals:                                    5         5       0 
 
Node      ID      Process name   Image name 
NodeA     11141   SMITH_1        DISK01:[SMITH]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 they have completed, and the number of transactions still active.

OpenVMS systems show the actual process names; on Windows and UNIX systems RTR produces a process name by combining user name and image name.

6.2.4 Monitor App2acp


RTR Application to ACP Messages, Node: NodeA  PID: -ALL- Process name: -ALL- 
   Image: -ALL-                                      14:21:19 Mon Jan 25 1999 
RTR Message Type     Client               Server               Other        
                     #     Bytes          #     Bytes          #      Bytes 
open_channel         0         0          0         0          0          0 
close_channel        0         0          0         0          0          0 
prepare_tx           0         0 
accept_tx            0         0          0         0                        
reject_tx            0         0          0         0                        
broadcast_even                 0                                          
start_tx             0         0                             
send_to_servr        0         0   
reply_to_client                           0          0   
request_info                                                   0          0 
set_info                                                       0          0 

Displays counts of messages and number of bytes from the application to RTRACP, as viewed from a specific node. Includes open_channel, close_channel, prepare_tx (prepare transaction), accept_tx (accept transaction), reject_tx (reject transaction), broadcast_event, start_tx, send_to_server, reply_to_client, request_info , and set_info . Refer to the C Application Programmer's Reference Manual for an explanation of the message types.

The default is to display counts for all PIDs and processes, for client, server, and other roles.

6.2.5 Monitor Appdelay


FLOW CONTROL STALLS BY PROCESS Mon Jul 16 2001 15:38:37, NODE: rtrdoc 
 
                         Txn traffic stalls      Bdcst traffic stalls    KBytes 
PID      Process Name    reqs times secs  max    reqs times secs  max     sent 
Total _  *                  0    0     0     0      0    0     0     0       0 
 

Displays counts of flow-control induced traffic stalls by application process.

6.2.6 Monitor Broadcast


                BROADCAST RECEPTION BY PROCESS 15:20:27   6-APR-1999 
 
Node      ID    Process name   Received Queued  Lost       Delivery Rate 
Total                              2750     5     17               850.0 
 
NODEA  20400249 SMITH RTR             0     0      0 
NODEA  2040024D JONES RTR          2750     5     17               850.0 
NODEA  2040024B BROWN RTR             0     0      0 
NODEA  2040024C ALLEN RTR             0     0      0 

Displays information about the RTR user events process. Fields displayed include number of user events enqueued for the application, number of user events received by the application, and number of user events discarded by RTR.

6.2.7 Monitor Calls


RTR API calls, Node: nodea             , PID: 2162    , Process name: -ALL- 
Image: -ALL-                                        16:38:05 Fri Feb 12 1999 
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_msg1_uncertain    -        0     0 
                                        mt_msgn                       0     0 
reply_to_client                0     0  mt_reply             0              0 
                                        mt_rettosend         0              0 
prepare_tx            0              0  mt_prepared          0              0   
accept_tx             0        0     0  mt_accepte           0        0     0 
reject_tx             0        0     0  mt_rejed             0        0     0 
broadcast_event       0        0     0  mt_u_event           0        0     0 
set_user_handle       0        0     0  mtr_event            0        0     0 
get_tid               0        0     0  mt_prepare                    0     0 
                  other                                   other 
request_info          3              0  mt_request_info      2        -     0 
set_info              0              0  mt_set_info          0        -     0 
error_text            2                 mt_closed            2 
set_wakeup            0 
                  calls   active     fail  timeout 
receive_message       9        1        2        2 
user wakeup           0        0 
 

Displays the total number of RTR API calls and their outcome for the processes on all the nodes being monitored. Use the /IDENTIFICATION= process-id qualifier to display the values for one specific process, otherwise the total values for all processes are displayed.

6.2.8 Monitor Channel


RTR CHANNELS BY TYPE PER PROCESS  16:41:13 Fri Feb 12 1999 
                    
                                                               Call-out 
Node     ID   Process name   Image name  Client    Server    Router  Backend 
Nodea  2162   SMITH_1        DISK01:[SMI... 1         0           0        0 

Displays the channels opened by the CALL RTR_OPEN_CHANNEL command.

OpenVMS systems show the actual process names; on Windows and UNIX systems RTR produces a process name by combining user name and image name.

6.2.9 Monitor Connects


 
               C o n n e c t i o n   S t a t u s   S u m m a r y 
 
           Node: nodea                    Tue Feb 16 1999 13:02:18 
 
Executive summary--------------------------------------- 
                Number of links up:     3        
            Number of links up (%):   100.0 
                 Required links up:   Yes 
         ------------------------------------------------ 
 
-Detail- 
 Node -> Link  State  Arch T'port Fail-reason 
--------------:-----:-----:------:-------------------------------- 
nodea->nodea      up alpha      - 
nodea->nodeb      up alpha    TCP 
nodea->nodec      up  i386    TCP 
 

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 has been attempted are highlighted. Link state and architecture of the remote node are also displayed. Summarizes link status and is less detailed than the MONITOR NETSTAT display.

6.2.10 Monitor Ctccalls


 ORTR Call history monitor screen on node:walkin               PID : -ALL- 
Image: -ALL-                                     at 16:48:32 Mon Jul 16 2001_ 
 Calls         Channel #                  State     Msg/Event    Ch.Used  Status 
 

Displays the history of calls for a specific client transaction controller.

6.2.11 Monitor Downstream


FLOW CONTROL STALLS DOWNSTREAM BY NODE & FACILITY Mon Jul 16 2001 15:40:21, NODE 
 
                                    Txn traffic       Bdcst traffic 
                                be->tr     tr->fe        be->tr 
Node  & Facility              reqs stall  reqs stall  reqs stall 
rtrdoc   Test 

Displays counts of flow-control induced traffic stalls downstream from the backend, between the backend and the router, and between the router and the frontend. Downstream traffic runs away from the backend.

6.2.12 Monitor Event


  
       EVENT ROUTING STATISTICS BY FACILITY  Fri Sep 08 2000 15:21:47 
 
                                 Destination              Transit 
Node & Facility                In    Out    Lost        In    Out    Lost 
Total                         180    175       5       180    180       0 
 
NODEA   FACCMS                 25     25       0        25     25       0 
NODEA   TESTFAC               155    150       5       155    155       0 

Displays event routing data by facility. Information includes events in transit from RTR to a destination facility and destination information showing number of events enqueued for the application (In column), number of events processed by the application (Out column), and the number of events discarded by RTR (Lost column).

6.2.13 Monitor Flow


FLOW CONTROL COUNTERS  Tue Sep 19 2000 14:08:06, NODE: -ALL- , FAC: -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                   2        0 
 
 Link         Data Rate      Waits     Pending   Reqs Sent      Cache in use 
NODEA =>NODEA         0          0           0           1      NODEA        0 
NODEA =>NODEB         0          0           0           0      NODEB    51456 
NODEB =>NODEB      2065        307           0         968 
NODEB =>NODEA      2065         70           0         999 

Displays the flow control internals.

6.2.14 Monitor Flostalls


FLOW CONTROL INDUCED STALLS BY FACILITY Mon Jul 16 2001 15:41:03, NODE: rtrdoc 
 
                                 Request traffic           Response traffic 
                                fe->tr     tr->be          be->tr    tr->fe 
Node  & Facility              reqs stall  reqs stall     reqs stall reqs stall 
rtrdoc    Test 
 

Displays counts of flow-contrl induced traffic stalls.

6.2.15 Monitor Frontend


FRONTEND STATUS BY NODE AND FACILITY Tue Nov 02 1999 10:46:24, NODE:NODEA 
 
Node    Facility                       FE             Reject   Retry   Quorum 
                                     State   Router   Status   Count  Rejects 
NODEA   RTR$DEFAULT_FACILITY      cnctd to    smith                2        0 
NODEA   funds_transfer            cnctd to    smith                2        0 

Displays frontend status and counts by node and facility, including frontend state current router, reject status, retry count, and quorum rejects.

6.2.16 Monitor Group


 
  Concurrency Measures    Tue Apr 6 1999 10:04:26, NODE: NODEA 
 
                                                              --  averages -- 
                          txn  -server-  --  transactions --  srv   txn   txn 
Partition     state     cnt  cnt  act  vreq vote  ack /csn    act  /sec  /csn 
RTR$DEFAULT   active      0    1    0     0    0    0    0    0.0   0.0   0.0 

Table 6-2 MONITOR GROUP Fields
Field Meaning
Partition Partition
state Partition state.
txn cnt Number of transactions executed for this partition.
srv cnt Number of servers active for this partition.
srv act Number of servers currently busy processing transactions for this sample.
The following fields track the progress of a transaction through the states: vote requested, voted, acknowledged.
vreq Number of transactions waiting for the server to vote.
vote Number of transactions that have been voted on by the server but not committed by RTR.
ack Number of transactions that have been committed but have not been acknowledged by the server. Acknowledgment occurs on a subsequent rtr_receive_message() call by the server processing this transaction to get a message for a new transaction.
/csn Number of transactions which have been grouped under the same "commit sequence number" (CSN). This grouping determines the ordering of transactions submitted to a secondary shadow server.
txn/sec The average rate of transaction starts per second for this partition.
txn/csn Average number of transactions which have been grouped under the same commit sequence number (CSN) since this partition became active. This average is computed as the quotient of the txn cnt column and the total number of CSNs.

6.2.17 Monitor Ipc


 
Node: NODE11               I P C   S u m m a r y    Fri Mar  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 respectively. 
 +-------------------------------------------------------------------------+ 
 
 
       | - - - - - O u t g o i n g / s - - - - | - - I n c o m i n g / s - -| 
Process   Messages ...kbytes   send() ...kbytes  Messages   recv() ...kbytes 
rtracp      110334     49744    73437     49744     73434   220299      5616 
3123B84F         0         0        0         0         0        0         0 
31232395     73282      5569    73280      5569    109930   293144     49685 
 

Displays interprocess communication message information.

6.2.18 Monitor Ipcrate


 
Node: NODE11               I P C    R a t e s       Fri Mar  5 1999 11:18:53 
 
 +-------------------------------------------------------------------------+ 
  This screen displays rate information on IPC messages, byte counts and IO 
  primitive usage. Display units are counts, kbytes and calls per second 
  respectively. 
 +-------------------------------------------------------------------------+ 
 
       | - - - - - O u t g o i n g / s - - - - | - - I n c o m i n g / s - -| 
Process   Messages ...kbytes   send() ...kbytes  Messages   recv() ...kbytes 
rtracp          44        19       29        19        29       86         2 
3123B84F         0         0        0         0         0        0         0 
31232395        28         2       28         2        41      110        18 

Displays interprocess communication rate information for messages.

6.2.19 Monitor Journal


 
   JOURNAL USAGE ON NODE NODEA            AT 10:36:05 Tue Apr  6 1999 
 
   LOCAL JOURNAL                           STANDBY JOURNAL(S) 
 
   JNL_LCL_BLOCKS_IN_USE       128         JNL_RMT_BLOCKS_IN_USE            0 
   [___             13%          ]         [                0%              ] 
   JNL_LCL_NR_BLOCKS           992         JNL_RMT_NR_BLOCKS              992 
   JNL_LCL_TOP_BLOCKS_USED     128         JNL_RMT_TOP_BLOCKS_USED          0 
   JNL_LCL_BLOCKS_AVAILABLE    864         JNL_RMT_BLOCKS_AVAILABLE         0 
   JNL_LCL_TX_ENTRIES            1         JNL_RMT_TX_ENTRIES               0 
   JNL_LCL_TX_RECORDS            2         JNL_RMT_TX_RECORDS               0 
   JNL_LCL_MEMORY_BYTES     530121         JNL_RMT_MEMORY_BYTES          4197 
   JNL_LCL_DISK_READS           31         JNL_RMT_DISK_READS              33 
   JNL_LCL_BLOCKS_READ         992         JNL_RMT_BLOCKS_READ           1056 
   JNL_LCL_DISK_WRITES          12         JNL_RMT_DISK_WRITES              0 
   JNL_LCL_BLOCKS_WRITTEN       14         JNL_RMT_BLOCKS_WRITTEN           0 
   JNL_LCL_ENTRIES_TOTAL       201         JNL_RMT_ENTRIES_TOTAL            5 
   JNL_LCL_RECORDS_TOTAL       398         JNL_RMT_RECORDS_TOTAL            9 
   JNL_LCL_RECORDS_READ         21         JNL_RMT_RECORDS_READ             0 
   JNL_LCL_REC_BYTES_READ     8006         JNL_RMT_REC_BYTES_READ           0 
   JNL_LCL_NONTX_ENTRIES         5         JNL_RMT_NONTX_ENTRIES            0 
 
   JNL_LCL_OPEN_JOURNALS    2 
    

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 for the displayed node. Standby journals are journals of standby nodes that are being accessed due to restart or catch-up situations. Under normal conditions, standby journal figures are all zero.

The bar graphs appear under the first line of the display
(JNL_LCL_BLOCKS_IN_USE).

6.2.20 Monitor Link


LINK COUNTERS  Tue Sep 19 2000 14:24:44, NODE: -ALL- , LINK: -ALL-  -> -ALL- 
 
ncf_protocol             0        nio_writing              0 
ncf_timeout              0        nio_reading              0 
ncf_linkexit             0        nio_wrerror              0 
ncf_disconnect           0        nio_rderror              0 
ncf_thirdparty           0        nio_rdincmp              0 
ncf_pathlost             0        nio_seqerr               0 
ncf_responses_sent       3        nio_bufovf               0 
ncf_queries_rcvd        11        nio_reads_active         3 
ncf_responses_rcvd       2        nio_writes_active        0 
ncf_queries_sent        10        nio_bytes_rcvd    44206961 
ncf_ipt_msgs_rcvd       16        nio_bytes_sent    44206996 
ncf_ipt_msgs_sent       16        nio_pckts_rcvd      412114 
ncf_link_gain            4        nio_pckts_sent      412114 
ncf_link_loss            0        nio_msgs_rcvd       189284 
ncf_aborted              0        nio_tmo_sends       161307 
ncf_rejected             1        nio_tot_stall_sec        0 
ncf_accepted             1        nio_tot_stalls           0 
ncf_confirmed            1        qrm_req_link_queue       0 
ncf_initiated            2        qrm_rsp_link_queue       0 

Displays a number of per-link counters. The /LINK= link-name qualifier can be used to display the values for one specific link, otherwise the total values for all links are displayed.


Previous Next Contents Index