IBM Web Services Navigator

Open views can be rearranged within the Eclipse window by clicking on their tabs and dragging them. For more information about rearranging views, please refer to the topic "Rearranging views and editors" in the Eclipse "Basic Tutorial."

To close a view, click on the X icon in its tab at the top of the view.

To open or re-open any of the IBM Web Services Navigator views, follow these steps:

1. On the Eclipse menu bar, select Window -> Show View -> Other....
2. In the Show View window, expand Websight, select one or more views, and click on OK.

The Service Topology view provides additional information when the cursor is moved over these objects:

• service blocks
• message arrows

• move node icon (cursor and solid rectangle): When this control is active, you can move service blocks around on the pane by dragging them with the left-hand mouse button.
• select zoom icon (cursor and dotted rectangle): When this control is active, you can zoom in on any area of the view by dragging a rectangle around it with the left-hand mouse button.
• zoom in icon (magnifying glass containing +): When this control is active, you can zoom into the view by clicking on the left-hand mouse button.
• zoom out icon (magnifing glass containing -): When this control is active, you can zoom out from the view by clicking on the left-hand mouse button.
• Home icon: When this control is selected, the view is automatically zoomed in or out to fit everything into the pane.

Hide Operations: When this option is disabled, operation names will be displayed in service blocks below machine names. When this option is enabled, operation names will be hidden. This option is disabled by default.

"<" key (less-than symbol)
"," key (comma symbol)
When these keys are pressed, the vertical scale is compressed by one-third.

">" key (greater-than symbol)
"." key (period symbol)
When these keys are pressed, the vertical scale is expanded by one-third.

"+" key (plus symbol)
"=" key (equal symbol)
When this key is pressed, the view is zoomed in by one-third.

"-" key (minus symbol)
"_" key (underscore symbol)
When this key is pressed, the view is zoomed out by one-third.

"Home" key
When this key is pressed, the view is automatically zoomed in or out to fit everything into the view.

The Transaction Flows view provides additional information when the cursor moves over these objects:

• machine labels
• service labels
• processing bars
• message arrows

• Time Scale -> Logical Time Scale: In this mode, message flows and business logic will be scaled evenly from top to bottom. That is, the vertical distance between consecutive events will be the same, regardless of how much time each represents. No time scale will be displayed along the right-hand edge of the view. This is the default time scale mode.
• Time Scale -> Linear Time Scale: In this mode, message flows and business logic will be scaled proportionally from top to bottom. That is, the height of each arrow and bar will be proportional to the amount of time it represents. A time scale labeled in seconds will be displayed along the right-hand edge of the view. If the clocks of the machines are not all synchronized, their message arrows and business logic bars may be adjusted up or down so that all messages flow forwards in time. A "double clock" icon will be displayed in machine bars to indicate that this adjustment has been made.
• Time Scale -> Raw Time Scale: In this mode, message flows and business logic will be scaled proportionally from top to bottom. That is, the height of each arrow and bar will be proportional to the amount of time it represents. A time scale labelled in seconds will be displayed along the right-hand edge of the view. If the clocks of the machines included in the log are not all synchronized, their message arrows may appear to flow backwards in time. A "double clock" icon will be displayed in machine bars to indicate that message arrows point backwards in time because the machine clocks are not synchronized.

The Transaction Flows view can highlight patterns of repeated invocations within transactions. To highlight repetitions, click on the Find repetitions icon in the title bar of the view. If the displayed transactions contain any repetitions, a grey rectangle will be drawn behind them, and the rectangle will be labelled with the number of repetitions.

• select zoom icon (cursor and dotted rectangle): When this control is active, you can zoom in on any area of the view by dragging a rectangle around it with the left-hand mouse button.
• zoom in icon (magnifying glass containing "+"): When this control is active, you can zoom into the view by clicking on the left-hand mouse button.
• zoom out icon (magnifing glass containing "-"): When this control is active, you can zoom out from the view by clicking on the left-hand mouse button.
• Find Repetitions icon (columns of circles and lines): When this control is active, any repeated patterns of invocations will be highlighted with a grey rectangle and labelled with the number of repetitions.
• Home icon: When this control is selected, the view is automatically zoomed in or out to fit everything into the pane.
• Menu icon (down-triangle): When this control is selected, the Time Scale menu is displayed, and one of the three Time Scale modes described above can be selected.

• Open Content: This option is active only when the cursor is located over a message arrow. When this option is selected, the Message Content view is displayed with the contents of the selected message.
• Optimal Fit: When this option is selected, the vertical scale is expanded so that all message labels are legible.
• Visible Transactions: When this option is selected, a sub-menu is displayed that lists all of the transactions in the view. Individual transactions can be hidden or displayed, or all transactions can be hidden or displayed. Hidden transactions are displayed in grey and cannot be selected. All transactions are visible by default.
• Hide All Labels: When this option is disabled and there is room for the labels, message arrows are labelled with the name of the message, and the first processing bar of each transaction is labelled with the transaction number. When this option is enabled, message labels and transaction numbers are not displayed. Message labels and transaction numbers are displayed be default if there is room for them.
• Home: When this option is selected, the view is automatically zoomed in or out in order to fit everything into the pane.
• Hide Data Matches: This option is active only when Data Tracking has been enabled in the Message Content view. When this option is selected, data tracking is disabled. Message labels will show message names instead of field names and data values.

"<" key (less-than symbol)
"," key (comma symbol)
When these keys are pressed, the vertical scale is compressed by one-third.

">" key (greater-than symbol)
"." key (period symbol)
When these keys are pressed, the vertical scale is expanded by one-third.

"+" key (plus symbol)
"=" key (equal symbol)
When this key is pressed, the view is zoomed in by one-third.

"-" key (minus symbol)
"_" key (underscore symbol)
When this key is pressed, the view is zoomed out by one-third.

"Home" key
When this key is pressed, the view is automatically zoomed in or out to fit everything into the view.

The Flow Patterns view provides additional information when the cursor moves over these objects:

• machine labels
• service labels
• processing bars
• message arrows

• "select zoom" icon (cursor and dotted rectangle): When this control is active, you can zoom in on any area of the view by dragging a rectangle around it with the left-hand mouse button.
• "zoom in" icon (magnifying glass containing "+"): When this control is active, you can zoom into the view by clicking on the left-hand mouse button.
• "zoom out" icon (magnifing glass containing "-"): When this control is active, you can zoom out from the view by clicking on the left-hand mouse button.
• "Find Repetitions" icon (columns of circles and lines): When this control is active, any repeated patterns of invocations will be highlighted with a grey rectangle and labelled with the number of repetitions.
• "Home" icon: When this control is selected, the view is automatically zoomed in or out to fit everything into the pane.

"<" key (less-than symbol)
"," key (comma symbol)
When these keys are pressed, the vertical scale is compressed by one-third.

">" key (greater-than symbol)
"." key (period symbol)
When these keys are pressed, the vertical scale is expanded by one-third.

"+" key (plus symbol)
"=" key (equal symbol)
When this key is pressed, the view is zoomed in by one-third.

"-" key (minus symbol)
"_" key (underscore symbol)
When this key is pressed, the view is zoomed out by one-third.

"Home" key
When this key is pressed, the view is automatically zoomed in or out to fit everything into the view.

In the initial view, the message content tree is fully expanded. Individual subtrees can be expanded by clicking on the "boxed-plus" icons, or collapsed by clicking on the "boxed-minus" icons. The entire tree can be fully expanded by clicking on the "double-boxed-plus" icon in the title bar, or fully collapsed by clicking on the "double-boxed-minus" icon in the title bar.

The Message Content view can track the flow of data through the transactions displayed in the Transaction Flows view. Data tracking shows which messages in each transaction contain selected data. Data can be tracked through transactions in two ways:

• Exact Data Matches shows messages that contain the selected field name and data value.
• Data Dependency Matches shows messages that contain values similar to the selected data.

Data tracking can be enabled by right-clicking on any row of the message content and selecting an option from the pop-up context menu.

• Expand All icon (double box containing "+"): When this control is selected, the current message will be completely expanded.
• Collapse All icon (double box containing "-"): When this control is selected, the current message will be completely collapsed.
• Link with other views icon (left and right arrows): When this control is active, the Message Content view is automatically updated whenever a message is selected in another view. That is, the Message Content view always displays the contents of the currently selected message.
• Menu icon (down-triangle): When this control is selected, the Hide menu is displayed, and one of the message content hiding options can be enabled or disabled:
• Hide Namespace nodes
• Hide SOAP Header

• Show Exact Data Matches: When this option is selected, the Transaction Flows view will label the messages that contain a field name and data value that is identical to the selected row.
• Show Data Dependency Matches: When this option is selected, the Transaction Flows view will label the messages that contain a data value and/or a field name that is similar to the selected row.
• Hide Data Matches: When this option is selected, data tracking is disabled. Message labels in the Transaction Flows view will show message names instead of field names and data values.

• Select the Service Topology view, and then select an arrow that represents all of the messages between two Web Services. The selected arrow is highlighted. Then select the Transaction Flows view. All of the corresponding request and response messages are highlighted.
• Select the Transaction Flows view, and then select an arrow that represents a request or response message between two Web Services. The selected message is highlighted (in solid yellow). Then select the Service Topology view. The corresponding arrow is highlighted (in dashed yellow, indicating only partial selection).

Help -> Help Contents

IBM Web Services Navigator User Guide

A printable version of the online documentation for the IBM Web Services Navigator is available in the included PDF document.

C:\EclipseWorkbench\eclipse\plugins\com.ibm.websightView_3.0.0\ReadMe.txt

C:\EclipseWorkbench\eclipse\plugins\com.ibm.websightView_3.0.0\ReadMe.txt

Transaction Flows view:

• Machines are represented in better order for nicer layout.
• Missing events are represented with "dashed" message arrows.
• Details of data tracking matches were added to flyover text.
• Message labels are now shown or hidden automatically.

Flow Patterns view:

• Averages and variations of performance data were added to the view.
• Total, average, minimum and maximum response times were added to flyover text.
• View now includes ability to view flow patterns with Logical or Adjusted Time Scales.
• View now includes ability to select and highlight an individual transaction in flow pattern view.

Message Content view: Data-matching options were added to pop-up context menu (in order to enable this feature, first define the eclipse VM environment variable: com.ibm.websightView.analysis=true).

New Statistics Tables view: Four new statistics tables were added.