RTView® 
User Guide


Sample TIBCO Hawk Microagent

A sample Hawk Spot microagent is provided to enable customers to see how to monitor or execute commands on a microagent without using their environment. Hawk Spot supports the following methods:

  • accelerate
  • addHawk
  • decelerate
  • deleteHawk
  • getAllData
  • getAngle
  • getColor
  • getColorAssignmentCount
  • getMaxThreads
  • getName
  • getReleaseVersion
  • getTraceLevel
  • getTraceParameters
  • resume
  • setAngle
  • setColor
  • setMaxThreads
  • setTraceLevel
  • setTraceParameters
  • suspend
Running Hawk Spot
On Windows
You can start from either the Windows Start Menu or the Command Prompt window.

From the Windows Start Menu:
 
Select Start-->Programs-->RTView-->Demos-->Simulators-->Hawk Spot

From an initialized command window :
 
type run_hawkspot

On UNIX
From an initialized terminal window :
 
type run_hawkspot


Method Repository
A Method Repository file is used to populate the initial values of drop down menus in the Attach to Data and Define Command dialogs. This makes it easy to create displays for agents and microagents when they are not online. See Application Options for more information on creating a Method Repository file.

It is possible to edit an existing Method Repository file, however the file name hawkmethodrepository.xml cannot be modified. If hawkmethodrepository.xml is not found in the specified directory or your current working directory, RTView will look in the lib directory. If the Method Repository file is not found, dialog drop down menus will remain empty until agents and microagents begin to come online.

To edit an existing Method Repository file, supported tags and attributes are as follows:
 
Tag Attribute Description
hawkmethodrepository xmlns Top level tag that includes the namespace attribute xmlns, which must be defined as www.sl.com (xmlns="www.sl.com")
storeMethodListMode Format of Method Repository changes according to the value of storeMethodListMode (values: 0=store common method lists 1=store all method lists)
methodlist name Method list name
method 
name Method name
async Method asynchronous value
impact Method impact value
returnfield Return field name
argument name Argument name
type Argument type
choice Choice for argument
agent name Agent name
connection name Connection name
microagent  name Microagent name
key Corresponds to name of method list

An example Method Repository file:

<?xml version="1.0"?>
<hawkmethodrepository xmlns="www.sl.com" storeMethodListMode="0">
        <methodlist name="Self_x86:Windows NT:4.0_4.0.0">
                <method name="describe"
                        async="false"
                        impact="0">
                        <argument name="Instance"
                                type="java.lang.String"/>
                        <argument name="Name"
                                type="java.lang.String"/>
                </method>
                <method name="getComponentInfo"
                        async="false"
                        impact="0"
                        returnfield="Date"
                        returnfield="Name"
                        returnfield="Version">
                        <argument name="Component"
                                type="java.lang.String"/>
                </method>
                <method name="getMicroAgentInfo"
                        async="false"
                        impact="0"
                        returnfield="Count"
                        returnfield="Help"
                        returnfield="Name">
                        <argument name="Name"
                                type="java.lang.String"/>
                </method>
                <method name="getReleaseVersion"
                        async="false"
                        impact="0"
                        returnfield="Date"
                        returnfield="Major"
                        returnfield="Minor"
                        returnfield="Name"
                        returnfield="Update"
                        returnfield="Version">
                </method>
                <method name="getSecurityInfo"
                        async="false"
                        impact="0"
                        returnfield="Description"
                        returnfield="Policy Class">
                </method>
                <method name="getUptime"
                        async="false"
                        impact="0"
                        returnfield="Total days"
                        returnfield="Total hours"
                        returnfield="Total millisec"
                        returnfield="Uptime">
                </method>
                <method name="turnDiagnosticsOff"
                        async="false"
                        impact="1">
                </method>
                <method name="turnDiagnosticsOn"
                        async="false"
                        impact="1">
                </method>
        </methodlist>
        <agent name="MyAgent1" connection="default">
                <microagent name="Self" key="Self_x86:Windows NT:4.0_4.0.0"/>
        </agent>
        <agent name="MyAgent2" connection="default">
                <microagent name="Self" key="Self_x86:Windows NT:4.0_4.0.0"/>
        </agent>
</hawkmethodrepository>  


 
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-2014 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