Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Operations and Administration : Access

Access
This section explains how to access TIBCO Mainframe Service Tracker information through TIBCO Hawk Display.
 
It is assumed that you have configured the Hawk agent. For details on the configurations, see the TIBCO Hawk Installation and Configuration manual.
Here is a summary of the procedure:
1.
Step 1  Start TIBCO Hawk Display — The console application dynamically discovers the Hawk agents on your network (also called the Enterprise Monitor). Select the agent associated with the TIBCO Mainframe Service Tracker.
2.
Step 2  Access Microagents, Methods, and Arguments — Obtain the microagents associated with the selected agent. In addition to the TIBCO Mainframe Service Tracker microagents, the agent also has default microagents for monitoring various system objects, such as log files, processes, and application metrics. Select a microagent to access its methods and associated arguments.
3.
Step 3  Invoke a Method — Select and invoke the desired TIBCO Mainframe Service Tracker microagent to extract monitoring information, carry out specified operations, or accomplish both of those tasks.
4.
Step 4  View Results — View the results of the invocation in table format.
Step 1  Start TIBCO Hawk Display
To start an instance of TIBCO Hawk Display, do the following:
On Microsoft Windows:
From the Start menu, choose All Programs > TIBCO > TIBCO Hawk x.x > Hawk Display or double-click Hawk Display in the TIBCO Hawk program group.
On UNIX:
Type startdisplay at a command prompt.
 
The TIBCO Hawk Display main window is displayed:
TIBCO Hawk Display dynamically discovers TIBCO Hawk agents on your network, grouping newly discovered agents by subnet and placing them in a container nested under Agents, labeled Discovered. As agents are discovered, the counters increment to reflect the current number of discovered agents.
TIBCO Hawk Display arranges monitored network nodes in a hierarchical tree of containers. Clicking a container in the left panel displays nested items on the right panel. In the above example, an agent is shown in the right panel.
Step 2  Access Microagents, Methods, and Arguments
To access the microagents associated with the selected agent, right-click the agent icon in the right panel and choose Get MicroAgents in the context menu:
The MicroAgents, Methods and Arguments window is then displayed:
This window contains four panels:
Microagents — The upper left panel lists the microagents associated with the selected agent. In this example, two TIBCO Mainframe Service Tracker microagents are displayed, labeled QASXKQ-on-LION:0 and QASXKW-on-LION:0. The other entries are default microagents.
Methods — The middle left panel lists the methods for a selected microagent. In this example, the TIBCO Mainframe Service Tracker microagent labeled QASXKQ-on-LION:0 is selected. The Job Status, Notification, and _OnUnsolicitedMsg methods are associated with that microagent.
Method Description — The bottom panel shows a description of the selected method. In this example, the Job Status method is selected and its description displayed.
Arguments — The upper right panel lists the arguments for the selected methods. In this example, no arguments exist for the selected method (Job Status).
Step 3  Invoke a Method
To invoke a method, click Invoke at the bottom of the window:
Step 4  View Results
An example of the results window for an invoked method is shown below. Here, the Job Status method was invoked.
Mainframe processes are listed as rows in the table (described here by the labels to the left of the table). The columns displayed are specific to the method invoked.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved