RTView® 
User Guide


Application Options

To access the Application Options dialog, in the Display Builder select Tools>Options.

Options specified in TIBCO Rendezvous tabs can be saved in an initialization file (RVOPTIONS.ini). If no directory has been specified for your initialization files and RVOPTIONS.ini is not found in the directory where you started the application, then RTView will search under lib in your installation directory. NOTE: When you start an RTView application from the Windows Start menu, it runs from the demos directory.  

NOTE: Options specified using command line arguments will override values set in initialization files.

There are four Application Options tabs for TIBCO Hawk: TIBCO Rendezvous Communication, TIBCO Rendezvous Monitoring, TIBCO Rendezvous Messages and TIBCO Rendezvous Cache.

TIBCO Rendezvous Communication
These values reflect TIBCO Rendezvous communication settings. When using rvd (the default), the Service, Network, and Daemon settings apply. Default values for rvd settings are defined in the table below. When using rva (required for applets), Host and Port parameters apply. If the Host is set to default, the local host will be used. If the Port is set to default, the TIBCO Rendezvous default port will be used. See Communicating with TIBCO Rendezvous for a detailed explanation of rva and rvd.

NOTE: Options selected on the TIBCO Rendezvous Communication tab are not applied to the current session of RTView. Click the Save button to record all TIBCO Rendezvous application options to the initialization file RVOPTIONS.ini and restart RTView to apply these changes.
 

 
Service Rendezvous Session Service. Default is TIBCO Rendezvous service default.
Network Rendezvous Session Network. Default is TIBCO Rendezvous network default (primary network interface for the host computer).
Daemon Rendezvous Session Daemon. Default is TIBCO Rendezvous daemon default (local daemon on TCP socket 7500).
RVA Flag Run in rva mode.
Host Host running rva. Default is the local host. This option is only used if running in rva mode.
Port Port on which rva is running. Default is the rva default. This option is only used if running in rva mode.


TIBCO Rendezvous Monitoring
This tab allows you to configure your TIBCO Rendezvous monitoring settings.

   
Show Monitor Tables in Data Dialog Select whether RTViewDs monitoring tables are displayed in the Subject list in the Attach to TIBCO Rendezvous Data dialog. The default is disabled.
Monitor Host Status Messages on Start Select to begin listening for TIBCO Rendezvous information messages on startup rather than waiting until a display references RTViewDs.HostStatus tables. The default is disabled.
Host Status History Depth Set the number of rows of data to keep for each host in the RTViewDs.HostStatus tables. The default is 1000. A value of 0 sets it to keep no rows.  A value of -1 sets it to keep an unlimited number of rows.
Run Rvtrace on Start Select to begin running rvtrace on startup rather than waiting until a reference is made to a RTViewDs.Multicast table. The default is disabled.
Rvtrace Period Set the rvtrace update period.  The default is 10. A value of 0 sets it to use the default.
Rvtrace Interface Specify the Network Interface to use when rvtrace is started.

NOTE: Additional information about determining the Network Interface can be found in the TIBCO Rendezvous Administration manual.  Refer to Chapter 11, "Protocol Monitor (rvtrace)" and, in particular, to the document titled "Selecting the Network Interface". 

NOTE: RTView runs rvtrace to collect TIBCO Rendezvous monitoring information. The rvtrace application is part of your TIBCO Rendezvous installation and uses a pcap facility to capture network packets. Before using rvtrace, you must first ensure that the pcap facility is properly installed. It is strongly recommended that you run your TIBCO Rendezvous daemon with the -reliability 0 option when using rvtrace to monitor TIBCO Rendezvous. This will prevent the daemon from requesting retransmissions and contributing to busy network problems. See your TIBCO Rendezvous documentation for more information.


 

TIBCO Rendezvous Messages
Message subjects listed on the TIBCO Rendezvous Message tab are used to populate drop down menus in the Attach to Data and Define Command dialogs. RTView starts listening for new messages added from the Subject Name field after you click OK, Apply, or Save.

The Message Repository saves message field information for all Message subjects and uses that information to populate the initial values of drop down menus. Message subjects will not be added to drop down menus until RTView has received at least one TIBCO Rendezvous message with that subject.
 

 
Subject Name Enter the name of a TIBCO Rendezvous Message Subject.
Add Add Subject Name to listing.
Remove Select Subject from listing and click Remove to delete.
Save Message Repository Click to save file that records current Subjects and applies values to drop down menus


Message Repository
Click Save Message Repository to create a file that saves message field information for all Message Subjects. In order for a subject to be saved in the Message Repository, RTView must have received at least one TIBCO Rendezvous message with that subject. Information stored in the Message Repository file will be used to populate the initial values of drop down menus. NOTE: The saved file will be named rvrepository.xml. If the name of the Message Repository file is changed, RTView will not be able to locate the file. As a result, drop down menus will populate based on message subjects added from Application Options dialog or those typed directly into the Attach to TIBCO Rendezvous Data dialog.

When you click Save Message Repository, a confirmation dialog will appear to verify the directory in which you would like to save the Message Repository file. If you specified a directory for your initialization files, all repository files will be saved to, and read from, that directory. If you select the lib directory, the repository file will be available from any directory where you run RTView. If you do not select the lib directory, the repository file will be saved in the directory where you started the current session and will only be available when you run RTView from that particular directory.

 

See the TIBCO Rendezvous Message Repository section for technical details on editing an existing Message Repository file.


 

TIBCO Rendezvous Cache
The Disable Data Cache option allows you to disable the caching of data in the TIBCO Rendezvous Data Source.

 
Disable Cache Data If selected the initial update on data attachments to multiple subjects (e.g. orders.STATUS.*) will return a table with a row for each message, but subsequent updates will include only the rows that have changed. NOTE: You must Save and restart for this option to take effect.

This option is useful when using TIBCO Rendezvous data attachments as input to the Cache data source or the Historian.

If selected, the Disable Cache Data option will apply to the following RTViewDs tables:

  • RTViewDs.HostStatusCurrent
  • RTViewDs.HostStatusTotal


 
 


 
SL, SL-GMS, GMS, RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2012 Sherrill-Lubinski Corporation. All Rights Reserved.

 

JMS, JMX and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only. 

 

Third Party Notice Requirements