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

Options specified in TIBCO Hawk tabs can be saved in an initialization file (HAWKOPTIONS.ini). On startup, the initialization file is read by the Display Builder, Display Viewer, Display Server, Data Server and Historian to set initial values. If no directory has been specified for your initialization files and HAWKOPTIONS.ini is not found in the directory where you started the application, then Enterprise RTView will search under lib in your installation directory. NOTE: When you start an Enterprise 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 two Application Options tabs for TIBCO Hawk: TIBCO Hawk Communication and TIBCO Hawk Methods and Alerts.

TIBCO Hawk Communication
This tab allows you to add and remove TIBCO Hawk connections and set your default connection. Enterprise RTView supports multiple connections to TIBCO Hawk.

If you are using only one connection, select default in the Connection list, edit it and click Add. If you are using more than one connection, type in the configurations including a unique connection name, then click Add. The new connection appears in the Conection list. To edit a connection, select it in the Connection list, edit it and click Add. To remove a connection, select it in the Connection list and click Remove, Apply, OK, Save applies all changes. Cancel effects all the recently made connections. If Enterprise RTView is unable to make a connection, an error message will appear on the console when you click Apply.

A unique name must be specified for each connection. This name is used to create an Agent Group by the same name containing all agents on that connection. A default connection is automatically created that can be modified but not removed. By default, TIBCO Hawk uses rvd. Different configurations apply to rva and EMS, as described below.

NOTE: Connections should have unique parameters or some agents may not be added to the appropriate group.

See Communicating with TIBCO Hawk for a detailed explanation of rva and rvd.

TIBCO Hawk Communication Settings
The following settings apply to rvd, rva and EMS.

Field	Description
Connection Name	Unique name for the connection.
Hawk Domain	TIBCO Hawk Domain. The default is null.
Hawk Transport	The transport to use when connecting to TIBCO Hawk. The default is rvd.

RVD
When using rvd (the default), the Service, Network and Daemon settings apply.
 
RVD Settings

Field	Description
Service	TIBCO Rendezvous Session Service. The default is 7474.
Network	TIBCO Rendezvous Session Network. The default is ;.
Daemon	TIBCO Rendezvous Session Daemon. The default is tcp:7474.

RVA
When using rva, 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.
RVA Settings

Field	Description
Host	Host running rva. The default is the local host. This option is only used if running in rva mode.
Port	Port on which rva is running. The default is the rva default. This option is only used if running in rva mode.

EMS
When using EMS, Server URL, User Name, and Password settings apply.
EMS Settings

Field	Description
Server URL	The complete URL for your EMS server. This must match the settings on the Transport tab of the TIBCO Hawk Configuration Utility. If nothing is specified, use the default: tcp://localhost:7222.
User Name	The user name for your EMS server. This must match the settings on the Transport tab of the TIBCO Hawk Configuration Utility.
Password	The password. This must match the settings on the Transport tab of the TIBCO Hawk Configuration Utility.

NOTE: Additional setup is required if you are using SSL with EMS Transport.

TIBCO Hawk Methods and Alerts
The TIBCO Hawk Methods and Alerts tab allows you to select the Store Method List Mode, save a Method Repository file and set the Rate to Remove Cleared Alerts or Display Existing Alerts.

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

Store Method List Mode
The Store Method List Mode option allows you to control how method information is stored in Enterprise RTView. When you change the Store Method List Mode, click the Save button to record this change in the initialization file. Because settings on this tab cannot be applied to the current session of Enterprise RTView, you must restart in order to enable the selected method list mode and then save a corresponding method repository file.

Store Common Method Lists - Stores a single method list for multiple microagents running on the same platform and version of Hawk. This option is memory efficient and the best choice for most users.

Store All Method Lists - Stores a method list for each microagent running. This options uses more memory, but enables data attachments to multiple microagents (on a single platform) that contain different method definitions for the same method name.

NOTE: Enterprise RTView will output an error message in your command window to alert you that the current method repository file does not correspond to the selected method list mode. If you continue to use Enterprise RTView with a method repository file that is incorrectly formatted, no method descriptions from that file will be used.

Method Repository
Click Save Method Repository to create a file that records the current listing of agents and microagents that are online at the time the file is saved. The information stored in this file is then used to populate the initial values of drop down menus in the Attach to Data and Define Command dialogs. This makes it possible to build displays when agents and microagents are offline. Depending on your Hawk Agent settings, it may take up to a few minutes for a complete listing of agents and microagents to come online. The saved file will be named hawkmethodrepository.xml. NOTE: If the name of the method repository file is changed, Enterprise RTView will not be able to locate the file. As a result, drop down menus will remain empty until agents and microagents begin to come online.

The format of the method repository file must correspond to the Store Method List Mode. The Display Builder must be started with the selected method list mode enabled in order for you to save a method repository file that is formatted correctly. When you save a new Store Method List Mode, you must restart Enterprise RTView (in order for the change to take effect) and then save a method repository file.

NOTE: Enterprise RTView will output an error message in your command window to alert you that the current method repository file does not correspond to the selected method list mode. If you continue to use Enterprise RTView with a method repository file that is incorrectly formatted, no method descriptions from that file will be used.

When you click Save Method Repository, a confirmation dialog will appear to verify the directory in which you would like to save the method 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 Enterprise 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 Enterprise RTView from that particular directory.
 

See the TIBCO Hawk Method Repository section for information on how to edit an existing Method Repository file.

Rate to Remove Cleared Alerts
Enter the time (in milliseconds) to control how often cleared alerts should be removed from Enterprise RTView. For example, if you set the rate to 300000 then cleared alerts will be removed every 5 minutes. This setting is useful to optimize performance if you are running displays over a long period of time on a system that generates a large number of alerts. If you do not enter a rate, cleared alerts will never be removed.

Display Existing Alerts
By default, only alerts that occur after you have started Enterprise RTView are visible in your displays. If you select this checkbox, Enterprise RTView will begin to request alerts as soon as a display is opened that contains data attachments to the RTViewDs getAlertData method. Existing alerts will be requested, one agent at a time, for each agent referenced in these data attachments. NOTE: TIBCO does not immediately return alerts, so the first time a display is opened there may be a delay before existing alerts are displayed.

Every 10 seconds (10000 milliseconds) alerts are requested for one agent until existing alerts are displayed for all agents referenced in data attachments to the RTViewDs getAlertData method. TIBCO documentation warns applications not to request all existing alerts at the same time as this may cause an unacceptably large number of simultaneous network messages.

Rate to Request Existing Alerts
Enter the time (in milliseconds) to control how often Enterprise RTView will request alerts. The default rate is 10000 milliseconds (10 seconds). In determining the request rate, you should consider the average number of alerts outstanding on the entire network when a display is opened that contains data attachments with the RTViewDs getAlertData method.

Enable Hawk Notifications
Select this checkbox activate the display of TIBCO Hawk notification events. The AlertString for these notifications will be NO_ALERT. By default, TIBCO Hawk notifications are disabled.

TIBCO Hawk Agent Groups
The TIBCO Hawk Agent Groups tab allows you to define Agent Groups and add them to the drop down menu in the Attach to Data dialog. As soon as this information is saved to HAWKOPTIONS.ini it will be used to populate Attach to TIBCO Hawk Data dialog menus each time you run Enterprise RTView.
NOTE: Agent Groups are automatically created for each TIBCO Hawk cluster and each Hawk Connection defined on the TIBCO Hawk Communication tab.
 

TIBCO Hawk Agent Group Name - Enter a name for the Agent Group.

Add -  Click the Add button to insert the Agent Group into the listing. NOTE: You must click Save in order for Agent Groups you've added to be listed the next time you run Enterprise RTView.

Remove - Select an Agent Group from the list and click the Remove button to delete. NOTE: It is not possible to permanently remove Agent Groups that are automatically created for TIBCO Hawk clusters.

Define TIBCO Hawk Agent Groups
To select which agents to add to a group, double-click on the name of a group from the TIBCO Hawk Agent Groups listing. The Select Agents dialog should contain a list of Available Agents that you can add. NOTE: It is not possible to modify Agent Groups that are automatically created for TIBCO Hawk clusters.
 

To add an agent, select an item from the Available Agents list and click on the Add button. If the agent you require is not listed, type your selection into the Enter Agent Name field.

NOTE: For agents that are not on the default connection, specify the connection in parentheses after the agent name. For example, to specify Agent1 on Connection1, use Agent1(Connection1). Click the Remove button to delete an item previously added to the Selected Agent list.

NOTE: It is not possible to add or remove agents while the selected Agent Group is currently updating an object. Validation colors indicate whether selected agents are valid.