Performance Analyzer GUI v10.2 User Guide

Halcyon Performance Analyzer GUI

v10.2 User Guide

Copyright

Copyright HelpSystems, LLC. All rights reserved.

www.helpsystems.comUS: +1 952-933-0609Outside the U.S.: +44 (0) 870 120 3148

IBM, AS/400, OS/400, System i, System i5, i5/OS, Power Systems, and iSeries are trademarks or registered trade-marks of International Business Machines Corporation in the United States and/or other countries.

Windows and Windows Server are registered trademarks of Microsoft Corporation in the United States and/or other countries.

Java is a registered trademark of Oracle and/or its affiliates

All other product and company names are trademarks of their respective holders. For third-party conditions and disclaimers. see the Release Notes in the Product Directory.

Introducing Performance Analyzer 4Overview ..................................................................................... 4

Device Manager 5Overview ..................................................................................... 5The Device Manager display....................................................... 6

Defined Devices Panel ...................................................... 6Messages Panel ................................................................ 6

Defining Devices ......................................................................... 7Adding a Device ..................................................................... 7

General Settings................................................................ 7Advanced Settings............................................................. 9SNMP Settings ................................................................ 10

Editing Devices..................................................................... 10Deleting Devices................................................................... 10

Device Manager Messages panel ............................................. 11Device Selection........................................................................ 12

Using the Performance Analyzer GUI 14Overview ................................................................................... 14Managing Devices within Performance Analyzer GUI............... 14

Adding a Device to Performance Analyzer GUI ................... 15Data Collection and Device display........................................... 17

Performance Analyzer GUI Options ..................................... 17Navigating the Performance Analyzer GUI display ................... 19

Information and Status Bar ................................................... 19Customizing the Display....................................................... 19

Auto Switch panel ............................................................ 20Charts panel .................................................................... 20Lists panel........................................................................ 20Window panel .................................................................. 20Color Scheme panel ........................................................ 21Maximizing chart panels .................................................. 22Resizing chart panels ...................................................... 22

View Mode and Edit Mode ........................................................ 23Switching between View and Edit Modes............................. 23View mode............................................................................ 23

Manually changing the device view ................................. 23Manually changing the page view.................................... 23

Edit mode ............................................................................. 24Moving chart panels within the current view ....................24Saving views.................................................................... 24

Using the default views .............................................................26Views .................................................................................... 26

Summary page ................................................................ 26Pools page....................................................................... 27ASP page......................................................................... 29Details Page .................................................................... 30Sorting columns............................................................... 30

Customizing the default views 31Overview ................................................................................... 31Customizing and Editing Pages ................................................ 32

Adding a Chart Panel ........................................................... 32Panel page....................................................................... 33Settings page................................................................... 34Advanced page................................................................ 36

Adding Performance Data fields........................................... 37Chart Types ..................................................................... 37Area Chart parameters .................................................... 39Bar Chart parameters ...................................................... 40Line Charts ...................................................................... 42Pie Charts ........................................................................ 44

Adding a List Panel .............................................................. 44Panel page ...................................................................... 45Settings page .................................................................. 46Advanced page ............................................................... 47Adding Performance Fields to a List Chart...................... 47

Editing a Chart or List Panel ................................................ 49Changing the sequence of display .................................. 49Editing Performance Data Field definitions ..................... 50Deleting a Chart Panel .................................................... 51Clone Panel..................................................................... 51

Creating custom views.............................................................. 52Adding a Page View............................................................. 52Edit Page.............................................................................. 52Delete Page ......................................................................... 52

Exiting the program................................................................... 53

Table of Contents

Introducing Performance Analyzer Overview

Introducing Performance Analyzer

OverviewThe Performance Analyzer GUI provides a visual representation, via a PC, of the current performancelevels of your IBM devices on which Halcyon Operations Center Suite has been installed.

Performance data can be viewed by ASP, Pool and Summary or your own customized page. Detailedpanel views within these pages can be customized, including data type, detail level and graphicalrepresentation mode, to provide a quick at-a-glance view of the IBM i performance data that is critical to thesmooth running of your organization.

Further ReadingPlease see the Performance Analyzer GUI Installation Guide for more information on system pre-requisitesand installation instructions.

Halcyon Performance Analyzer- 4 -

Device Manager Overview

Device Manager

OverviewThe Device Manager is the component of Performance Analyzer that is used for the manual entry ofdevices, device categorization and the launch of default applications.

Devices must be loaded or be present in the Device Manager before they are available for selection inPerformance Analyzer. See for more information.

The Device Manager component can be opened directly from within Performance Analyzer by clicking the icon at the top-left of the display and then select Device Manager from the drop-down menu.

Alternatively select Windows Start | Halcyon | Device Manager to open a Device Manager session.


Device Manager The Device Manager display

The Device Manager displayBy default, the main window contains two panes:

• Defined Devices: default position is the top pane of the main window

• Messages: default position is the lower pane of the main window

Defined Devices PanelThis panel shows the details of any devices which have been manually added to the Device Manager. Bydefault, the Device Name, IP Address, Connection and Read Timeouts are displayed.

Messages PanelThis panel shows the details of any messages sent to, from or between devices listed in the DeviceManager. Date/Time and Message details are shown by default.

Re-arranging the displayEach pane can be minimized, closed or moved and resized as required. Information is listed in each panein table columns, the contents of each column can be can be arranged in ascending/descending order byclicking any column title to toggle the view.

Column positions can also be rearranged by dragging any column horizontally to a new position.

Columns can be added to or removed from each pane by right clicking a column bar and selecting ordeselecting the column(s) required.


Device Manager Defining Devices

Defining Devices Devices can be manually added to then be available for monitoring from within Performance Analyzer. Thefollowing section describes how to add a device.

Adding a DeviceEither click the Add Device icon from the toolbar or select Devices | Add Devices from the main menu.

The Add Device dialog is displayed.

There are three separate areas into which information can be entered:

• General

• Advanced

• SNMP

General Settings

Information PageThe following parameters are available on the Information page of the General Settings tab.

GroupDevice Groups are used to be segregate groups of say, similar devices, or all devices belonging to aspecific department.

The Device Group (if used) can be specified using a selection from the drop-down menu. Groups areadded using the Tools | Manage Groups option.

Name The Device name MUST be the same as the actual system name.

DescriptionEnter an accurate description by which the device can be identified.



Device TypeFrom the drop-down choice menu, select the device type. The only selection that will function with thePerformance Analyzer product is Power/System i.

Network Host/AddressEnter the IP address of the device as it is registered in your network.

Display PageThe followings parameters are available on the Display page of the General Settings tab.

ColorFrom the drop-down menu, select the color in which this device is displayed in Performance Analyzer.

LocationIf required, specify the physical geographical location of the network device.

Time ZoneIf required, enter the time differential to take account of the geographical location of the device. Forexample, with the host device based in the UK, devices in Paris, France, would have a time differential of+1.00 to GMT.

The settings for this field are derived from the Windows® time zone defaults, as found in Windows® Start |Control Panel | Date and Time.

When an alert is received from a device located in a different time zone, the time is extracted from theincoming alert and an adjustment is made via the setting in this field on the receiving Enterprise Consoledevice prior to being displayed.

The ‘Use Current’ setting for this field automatically sets the time zone to the local setting derived from thedevice to which the alert is sent. This setting is useful for devices such as printers and those that sendSNMP Traps.

Note: Ensure that the time settings on the remote device are correct prior to activating this feature otherwise timing inaccuracies of alert data can occur.

Note: Any changes to the Time Zone settings in this field override any pre-existing settings on devices running Server Manager.

Support Page The parameters on this page are used to enter the details of any support information. None of theseparameters are mandatory.

Contact NameIf required (or known), enter the name of associated personnel responsible for this device.

CompanyIf applicable, enter the name of the associated company/division where the device is installed.

Associated Application NameThis option is not applicable within Performance Analyzer.

Test Application This option is not applicable within Performance Analyzer.



Advanced Settings

Timeout PageThe following parameters are available on the Timeout page of the Advanced Settings tab.

Connection TimeoutThe Device Manager abandons its connection attempt after the time period (in seconds) specified in thisfield. The default setting is 120 seconds.

Read TimeoutThe entry in this field sets the read timeout limit between the Device Manager and the remote device. Thedefault setting is 120 seconds.

Connection PageThe following parameters are available on the Connection page of the Advanced Settings tab.

Alternative IP AddressClick Add to add one or multiple Alternative IP Addresses to account for devices with multi-IP addresscapability or those that have further IP Addresses linked to the main IP Address.

External InterfaceIf this device is located behind a firewall, enter an external IP address via which any connection can bemade to ensure that alerts are transmitted to the Enterprise Console.

Settings PageThe following parameters are available on the Settings page of the Advanced Settings tab.

User Name/PasswordIf required, enter a user name and password combination used to access this device.

Power i Systems Settings

Serial NumberEnter the serial number of the device.

Connect on PortThe entry in this field specifies the port number on the Power/System i to which Performance Analyzerconnects. This value must match the Port Value in the *SYSTEM Location of the Power/System i device.This value can be found as the top entry in Configuration Menu > Work with Remote Locations from theHalcyon menu on the Power/System i device.

If the Power/System i device is running multiple environments, you must add a device to the DeviceManager to represent each individual environment as the port setting is different for each.



Notes PageUse this page to enter any free-text notes about the device. These notes can be used as a substitutionvariable when sending an alert from this device.

SNMP SettingsThe options on this page are not required for Performance Analyzer.

Editing DevicesIt is possible to edit the details of any Device listed in the Defined Devices panel.

From the defined devices listed, click on the one that you want to edit.

From the Device Manager menu ribbon, select Edit Device from the Device Manager menu ribbon.

Click Edit to open the Edit Device dialog. Parameters that can be edited on this display are the same asthose used when Adding a Device.

Deleting DevicesIt is possible to delete any Device listed in the Defined Devices panel.

From the defined devices listed, click on the one that you want to remove.

From the Device Manager menu ribbon, select Delete Device from the Device Manager menuribbon.

When prompted, click Yes to confirm the request or No to cancel.


Device Manager Device Manager Messages panel

Device Manager Messages panelThe Device Manager Messages panel is used to display warning and error messages regarding failedconnections or porting issues with devices in the Defined Devices panel.

Additionally, if Logging of Informational and /or Diagnostic messages has been enabled, these messagesare also displayed within this panel.


Device Manager Device Selection

Device Selection This allows you to select which IBM i devices that have been defined in Device Manager are available forview in the Performance Analyzer software.

Click the icon at the top-left of the display and then select Device Selection from the drop-down menu.

The Manage Device dialog is displayed.

The following parameters are available on the Manage Devices dialog.

Host/IP AddressEnter the IP Address of the PC on which Device Manager is installed. Click Load to retrieve all Power/System i devices from this version of Device Manager.


Device Manager Device Selection

Connection TimeoutThe time in seconds before the connection between the PC hosting Device Manager and the Power/System i is dropped. This setting defaults to 10 seconds.

Read TimeoutThe time in seconds before data is considered to have not been read between the PC hosting DeviceManager and the Power/System i. This setting defaults to 5 seconds.

Device SelectionFrom within the Device Selection window, click against each device that you want to be available forselection in Performance Analyzer.

Click OK to confirm the settings and device selection.

CHAPTER 0


Using the Performance Analyzer GUI Overview

Using the Performance Analyzer GUI

OverviewThe default view shown when opening the Performance Analyzer GUI is the last saved view from when thePerformance Analyzer GUI was last in use.

Note: For new installations, the default view is blank as devices must first be added. See Managing Devices within Performance Analyzer GUI for more information.

For more information of views within the Performance Analyzer GUI please see:

• Using the default views

• Customizing the default views

• Creating custom views

Managing Devices within Performance Analyzer GUIIBM i devices need to be added to the Performance Analyzer GUI prior to the associated performance databeing available for view.


Using the Performance Analyzer GUI Managing Devices within Performance Analyzer GUI

Adding a Device to Performance Analyzer GUIUpon opening the Performance Analyzer GUI, a blank window, consisting of a series of panels isdisplayed. In the top left corner of this display is the Device Panel.

In the bottom right-corner of this panel is an arrow (circled in the figure above). Click this arrow to displaythe Manage Devices dialog.

All IBM i Devices that have been defined in Device Manager are listed in the Device Selection panel of thisdialog.

Host/AddesssDisplays the IP address of the local device on which this instance of Performance Analyzer GUI isinstalled.

Connection TimeoutEnter the time, in seconds, after which a connection attempt to the selected IBM i devices is deemedunsuccessful. The default setting is 10 seconds.

Read TimeoutEnter the time, in seconds, after which an attempt to read data from the selected IBM i devices is deemedunsuccessful. The default setting is 5 seconds.


Using the Performance Analyzer GUI Managing Devices within Performance Analyzer GUI

Click against all devices for which you wish to display Performance Data, so that a tick mark appears nextto the device and click OK.

Performance Data is now available for the selected device(s).

Note: If performance data is not visible straight away, close the Performance Analyzer GUI and re-open the program.


Using the Performance Analyzer GUI Data Collection and Device display

Data Collection and Device displayPrior to changing any of the views on the default display it is good practice to determine from which IBM idevices you want to gather performance data, the time period over which the data is displayed and themethod used to view more than one device via the same display. These options are all configured from theOptions Tab, on the menu bar at the top of the display.

Note: See Managing Devices within Performance Analyzer GUI for more information on adding devices for display within the Performance Analyzer GUI.

Performance Analyzer GUI OptionsThe options tab is split into four subsequent panels.

Startup panelThe Startup panel within Performance Analyzer options contains the following parameters.

Show Last DeviceIf checked, this option shows performance data for the last device that was visible when the view waspreviously closed. If not checked, performance data is displayed for the first enabled device in the ManageDevices dialog.

Start AutoSwitchAuto-Switch allows you to automatically switch between devices and/or pages.

Note: For more information regarding Auto-Switch see Auto-Switch Mode panel and Auto Switch panel.

If checked, the current view is auto-switched at the rate determined by the values entered in the Auto-Switch Mode panel of this display. If not checked, the current view remains static and subsequent viewsmust be manually invoked.

Data panelThe Data panel within Performance Analyzer options contains the following parameters.

Cache SizeSpecifies the time interval over which performance collection data is retained in memory for displaypurposes. The default value is 20 minutes and the maximum value that can be set is 60 minutes. Note thata high volume of data combined with other display options may create a ‘cluttered’ display which can thenbe difficult to view.

Note: If you change this figure, you must wait for the next set of performance data to be returned from the IBM i before the view is amended.

Max WorkersWorkers are the communication links that check the IBM i devices for performance data and report back tothe Performance Analyzer GUI.


Using the Performance Analyzer GUI Data Collection and Device display

It is recommended that for every 2 IBM i devices for which you are collecting data, you assign 1 worker.Therefore, if you have 10 devices for which you are collecting performance data, you would need 5workers.

If the ratio between devices and workers is greater than two, it is likely that the speed with whichperformance data is collected is negatively impacted. The default setting for this field is 5 workers. If thereare more workers than systems, there is no impact on system performance.

Logging panelThe Logging panel within Performance Analyzer options contains the following parameters.

Log InformationalIf checked, all system informational messages are logged. These can be found in the same directory pathas the diagnostic messages.

Log DiagnosticIf checked, all system diagnostic messages are logged to the log file; HPA.hlf, which is located (by default)in directory path;

C:\Program Files\Halcyon\Performance Analyzer\ Logs

(or the alternative directory path to which the software was installed).

Auto-Switch Mode panelThe Auto-Switch Mode panel within Performance Analyzer options contains the following parameters.

Note: See also Auto Switch panel for more information on using auto-switch mode.

Switch EveryDefines the time interval between which devices and/or pages are automatically switched on the currentview if auto-switching is active. The default setting is 30 seconds.

PeriodSpecifies the unit of time for the interval between which devices and/or pages are automatically switchedon the current view if auto-switching is active. Either Seconds or Minutes can be selected. The defaultsetting is Seconds.

Switch DevicesIf checked, the Performance Analyzer GUI display automatically switches the view to the next listed deviceafter the time period defined in the ‘Switch Every’ and ‘Period’ fields.

Switch PagesIf checked, the Performance Analyzer GUI display automatically switches the view to the next page for thecurrent device after the time period defined in the ‘Switch Every’ and ‘Period’ fields.

Note: If both Switch Devices and Switch Pages are checked, the auto-switching of all pages contained within the current device view is undertaken before auto-switching to the next device.

Pressing ESC stops auto-switching.


Using the Performance Analyzer GUI Navigating the Performance Analyzer GUI display

Navigating the Performance Analyzer GUI displayThe default Performance Analyzer GUI display is made up of three pages:

• Summary

• ASP

• Pools

Each of these pages has its own panels in which various aspects of system performance is displayed.Each panel, within each page, can be customized to display the performance data information that youwant in the format that you want it displayed.

Panels can be resized, minimized, maximized and moved on the page view.

Information can be displayed as an area chart, line chart, bar chart or pie chart.

Additionally, you can create custom pages which can display any aspect of system performance from theavailable data.

Note: Custom pages are defined across the Performance Analyzer GUI and not by device.

Information and Status BarThe information and status bar is displayed at the bottom of the Performance Analyzer GUI. Information onthis display includes:

• The name of the computer on which the performance Analyzer GUI is running

• The IP address of this computer

• The current view

• The current status of Auto-Switching mode

Items can be removed from this display, by right-clicking on the bar and removing the check mark againstthe item on the subsequent pop-up menu that is displayed.

Click the Auto-Switch Inactive/Active status bar to toggle between modes. With Auto-Switch active, this bardynamically indicates the time remaining before the page and/or device is switched.

Customizing the DisplayThe appearance of the display and the data contained within, can be altered by settings contained withinthe Display tab, on the menu bar at the top of the display.

The Display tab contains five panels which are used to configure display settings throughout thePerformance Analyzer GUI.



Auto Switch panelThe auto-switch panel is used to activate the use of auto-switching within Performance Analyzer GUI.Without starting the auto-switch facility either here (or via the button on the status panel at the bottom ofthis display) the view remains static.

Click Start to begin auto-switching (providing other auto-switching configuration options are enabled). ClickStop to end auto-switching and leave the current view in static mode.

Charts panelThe charts panel is used to define views of charts contained within panels. The settings defined isapplicable to all panels and cannot be applied to a specific chart, panel or view.

Grid LinesSpecifies if you want grid lines to be displayed behind the performance data collection levels on area, barand line charts. because of the graphical representation, pie charts do not require grid lines.

Select from:

• None

• Horizontal

• Vertical

• Both

Show EdgesIf checked, displays definitive edging to all performance data displayed on any type of chart. This helps todistinguish between data levels where similar color schemes have been deployed.

Lists panelThe lists panel is used to define views of lists contained within panels. The settings defined is applicable toall panels and cannot be applied to a specific list, panel, or view.

Grid LinesSpecifies if you want grid lines to be displayed behind the list information. The same options are availableas those in the Grid Lines setting of the Charts panel.

Highlight Sort ColumnIf checked, the column by which the performance data information has been sorted is highlighted within thedisplay.

Window panelResetUse the Reset icon to ‘snap’ the display back to full view if it has been reduced or altered in any way.This functionality only operates if the Performance Analyzer GUI has been reduced in size or moved fromfull view.



Color Scheme panelSettings on the color scheme panel allow you to change the background color setting of the PerformanceAnalyzer GUI.

The Enterprise Console uses the standard Windows color schemes that can be applied to change theappearance of ALL components of Enterprise Console.

Use the vertical scroll bar to display a selection of schemes from which a choice can be made oralternatively click on the icon to expand the window to display all available schemes in one panel.



Maximizing chart panelsChart panels can be maximized within the current view by clicking on the single window icon in the topright corner of each panel. This closes all other chart panels within the same frame, so that the panel that ismaximized is the only graphical view. All other chart panels within the same frame are minimized to a tabview, identified by their caption title.

To return the display to its previous view, click the double window icon on the enlarged chart panel.

Resizing chart panels Chart panels can be resized within their current frames to extend or reduce their appearance within thecurrent view.

Move the pointer to over the vertical or horizontal frame boundary of the chart panel depending in whichdirection you wish to resize the selected panel.

Depending on which boundary the pointer is situated over, it changes shape to either a vertical resize orhorizontal resize pointer. Click-and-drag the frame boundary to the required position and release. All otherchart panels in the display are resized accordingly to accommodate the newly sized panel.


Using the Performance Analyzer GUI View Mode and Edit Mode

View Mode and Edit ModeThe Performance Analyzer Gui has two different modes of operation.

• View Mode

• Edit Mode

Switching between View and Edit ModesTo switch between View and Edit modes, click the View icon in the quick access toolbar in the top-rightcorner of the Performance Analyzer display.

View mode In View mode you can view and resize (but not move) individual panels in the display. You can also changecolor schemes. View mode is the default mode, whenever the Performance Analyzer GUI is opened. Youcan also view individual devices either manually or by using the Auto-Switch option.

Manually changing the device viewIf you have not activated auto-switching of the device view, yet have more than one device for which youwish to view performance data, you must manually change the device. This is done by selecting Home >Device Panel.

Click either of the directional arrows to scroll through the available devices, or use the drop-down choicemenu to select the device directly from those listed. As each device is loaded in turn, the individualperformance data changes accordingly.

Manually changing the page viewIf you have not activated auto-switching of page view, you must manually move between the pages for thecurrent device. This is done by selecting Home > Page Panel.

Click on each icon in this panel to display the associated performance data for the selected device.



Edit modeIn Edit mode you can perform exactly the same functions as when in View mode but can additionally movepanels within the display to new positions prior to saving the view as a new layout.

Note: You cannot edit pages or panels within the Performance GUI Analyzer if your license code only provides a ‘read-only’ view of the performance data.

You are unable to edit pages and panels when auto-switching is active.

Moving chart panels within the current viewPanels can be moved to new locations within the current view, so that you can set the display to your exactrequirements.

Note: In order to move chart panels you must be in Edit mode.

To re-position a panelLeft-click on the header bar of the panel you want to move and with the mouse button still depressed, beginto move the panel to the new location within the display. A re-positional display appears.

The blue highlighted area of each of the directional arrows in this display shows the projected new locationof the panel being moved if the area is selected. Individual arrows also appear at each directional point atthe perimeter of the display.

Either drag the panel to the desired positional marker on the central display or to one of the perimetermarkers and release the mouse button. The display changes to reflect the new positioning of the selectedpanel.

If you completely overlay a panel with another panel, a tabbed view comes into operation, wherebyseparate views within the same panel are accessed by clicking on the relevant tab.

If you make a mistake or cannot return the display to a position with which you are satisfied, simply closethe Performance Analyzer GUI and do not save the changes made. Then re-open the PerformanceAnalyzer GUI and the display is returned to the default display as it was before you started making thechanges.

To preserve the original default view, you must save the newly created view as a new view. This process isdescribed in the following section.

Saving views Unless you wish changes to be made to the actual default view, you must save any amended view as aseparate page view.

1. On the menu bar of the Performance Analyzer GUI display is a system icon.

2. Left-click on this icon to display a pop-up menu.

3. Select Save View As to display the Save As dialog.

4. Enter the name by which you wish to save this view and click OK to save.



The saved view can now be accessed from within the same menu, under Views.


Using the Performance Analyzer GUI Using the default views

Using the default viewsUpon opening the Performance Analyzer GUI, you are presented with the Home page view containingperformance data applicable to either the ASP, POOLS or SUMMARY of the current IBM i device.

ViewsThere are three default pages supplied with the Performance Analyzer GUI. Each page provides a differentview of the IBM i device, utilizing different types of chart and panel display.

Summary page The default summary page gives an overview of the CPU, ASP, Pools and Jobs details within a singleview.

The following information is displayed:

System panel

Displays the following performance data as a bar chart

• CPU %

• DB I/O CPU%



• ASP panel

Displays the following performance data as an area chart

• System ASP%

• LPAR Capacity %

• Pools panel

Displays the following performance data as pie charts

• Pool Size (As *BASE, *INTERACT, *MACHINE, *POOL)

• Batch Jobs (As Batch Jobs in Run)

• Total Jobs (As Active Jobs, Total Batch Jobs)

Pools pageThe default pools page displays the following panel information:

• Pool Transitions panel

Displays the following pool performance data as a bar chart

• Active > Wait/Min

• Wait > Inel/Min

• Active > Inel/Min



• Pool Pages/Sec panel

Displays the following pool performance data as a pie chart

• *BASE

• *INTERACT

• *MACHINE

• *SPOOL

• Pool Faults/Sec


• *BASE

• *INTERACT

• *MACHINE

• *SPOOL

• Pool DB Pages/Sec panel


• *BASE

• *INTERACT

• *MACHINE

• *SPOOL

• Pool DB Faults/Sec


• *BASE

• *INTERACT

• *MACHINE

• *SPOOL

• Pool Size


• *BASE

• *INTERACT

• *MACHINE

• *SPOOL



ASP pageThe default ASP page displays the following panel information:

• % Used panel

Displays the following ASP performance data as a bar chart

• ASP 1

• System % Used panel

Displays the following ASP performance data as a bar chart.

• ASP1

• Disk Count

Displays the following ASP performance data as a bar chart.

• ASP1



Details PageThe details page provides System, ASP, Pool and Job information in list format rather than as a graphicaldisplay.

Sorting columnsUsing the Detail List view, it is possible to alter the display by changing the order in which the columnswithin each panel are sorted.

The default view shows each panel sorted by time in descending order (earliest first). However, as anexample, you may wish to see at which time the CPU was at it’s busiest. In this instance, click the title barof the ‘CPU%’ column twice (once changes the sort but it is now in ascending order). The point at which theCPU% was at its highest is now at the top of this column. To return to sorting the panel by time, click twiceon the title bar of the ‘Time’ column. Other columns can be sorted using the same method.

Note: After changing the sort order of the columns, you can either change them back to the default settings, exit the program without saving any changes or save the new layout as an alternative view. See Saving views for more information. If you do not perform either of these actions, the changed sort order will form part of the default view the next time the page is displayed.


Customizing the default views Overview

Customizing the default views

OverviewThe Summary, Pools, ASP and Details pages represent standard default views to get you started. Onceyou are familiar with the layouts and graphical representations, you can begin to customize these views toyour own requirements and create your own pages tailored to the individual demands of your enterpriseand organization.

All of the display elements of the Performance Analyzer can be customized to suit your own requirements.

Note: You cannot edit pages or panels within the Performance Analyzer if your license code only provides a ‘read-only’ view of the performance data.


Customizing the default views Customizing and Editing Pages

Customizing and Editing PagesThis is the first step in customizing views and allows you add, edit, clone or delete panels to and fromexiting page views.

Note: You are unable to edit pages and panels when auto-switching is active.

From the Quick Access bar, select Edit mode. Two additional menu bar options, Pages and Panels aredisplayed under the heading ‘Edit Tools’.

Adding a Chart PanelStart by selecting the view to which you want to add a chart panel and select Edit mode.

Note: It is good practise to keep panels of a similar style and performance data together on the same page. However, panels can always be moved at a later point.

From the Edit Tools section on the menu bar, select Panels. A drop-down tool bar is displayed.

Click the Add Chart Panel icon . The Add Chart Panel dialog is displayed. The fields on this dialog,define the performance data information displayed and the format in which this information is presented.



There are three pages contained on this dialog.

• Panel

• Settings

• Advanced

Panel pageThe panel page is used to define the basic configuration of the panel on the display. From this page, youadd, edit and delete the performance collection criteria and the chart format definitions

CaptionEnter the name of the panel. This is displayed at the top of the panel for reference and is best suited to aaccurate description of the panel contents.

IconFrom the drop-down choice menu, select the icon, that is displayed next to the panel caption. Icons are notunique to the page view. The same icon can be used multiple times on the same page.

Field SelectionDisplays fields that have been defined for performance data reporting on this panel. At least one field mustdefined in order for the panel to be active.

Note: See Adding Performance Data fields for more information.



Settings pageThe settings page is used to define additional elements that may enhance the display of performance data.

Show HighlightsIf checked, this alternates the color display of any performance field setting that reports a value as beingabove the threshold setting defined for the field as displayed within this panel.

Note: See Show Thresholds for more information.

Show LegendIf checked, a key to define what is being displayed by this chart panel is displayed. If unchecked, just thedata is displayed without any reference to the performance data this it represents.

Show MarksIf checked, displays vale marks next to each piece of performance data, providing an exact figure of thegraphical representation. Use of these marks can assist in providing detailed information but can lead tothe ‘cluttering’ of the display if a large amount of performance data is displayed.

Examples of a chart both with and without this setting checked are shown overleaf:



Show ThresholdsIf checked, displays the threshold levels for fields for which threshold values have been set within thispanel. Threshold levels are displayed as a tint of the color for the performance data field that theyrepresent. The display of different threshold levels on the same display depends on the sequence in whichthe fields are specified.

Note: See Changing the sequence of display for more information.

Show Zero ValuesIf checked, this chart displays performance data values that are zero. This can take up space on the actualchart. To remove unwanted zero values from the chart, deselect this option.



Advanced pageThe advanced page of the Add Chart Panel dialog is used to define the amount of performance datadisplayed at any one time and the color schema to be deployed if one is not selected at field level.

Show All RecordsIf selected, all performance data records available for the specified time interval are displayed on this chart.

Show LastIf selected, only the last number of performance data records specified in this field are displayed on thischart for the specified time interval.

Starting ColorIf do not wish to define individual colors for the performance data displayed on this chart, you can define astarting color from which all performance data records on this chart are then derived.

Use the vertical scroll bar to access the starting color that you wish to use. When you are satisfied with yourselection, click the box to the left hand side of the color bar so that a tick mark appears. This is now theselected color from which all performance data records on this chart are then derived.



Adding Performance Data fieldsThe new chart cannot be added until you have selected the performance data records that are to bedisplayed within.

To do this, you must select the Panel page of the Add Chart Panel dialog.

From this page, click Add to open the Select Chart Type dialog.

Chart TypesThere are four separate chart types that can be used to display performance data records. All but the PieChart type can be used to display information simultaneously within the same panel.

Area ChartThe area chart type displays information in the form of a continuous area on the chart to represent thereturned performance data.



Bar ChartThe bar chart type displays information in the form of a single shaded area of the chart to represent thereturned performance data.

Line ChartThe line chart type displays information in the form of a continuous line to represent the returnedperformance data.

Pie ChartThe pie chart type displays information in the form of a circle, divided into sectors to represent eachseparate item of performance data.

Note: If you select the Pie Chart display option you cannot add other types of chart to this panel.



Once you have selected the chart type, click OK to open the add field dialog for the selected chart type,where you can define the performance field characteristics to be displayed on the chart.

The fields available on this dialog depend on the type of chart that has been selected.

Area Chart parametersThe following parameters are available when defining Area Charts.

Details

• Category: Defines which type of performance data record is required.

• Field: Defines the actual performance data record. The options in the drop-down choice menu for thisfield, change depending on the chosen category.

• Color: Click the check box to enable the use of the drop-down choice menu to define the color for thisfield when displayed within the chart. If not checked, the Starting Color defined in the Advanced sectionof the chart page definition is used. To create your own color, use ‘Custom...’.



Highlight Settings

• Highlight Values Over Threshold: Click to enable the use of thresholds and highlighting of values thatexceed the threshold limit for this performance field.

• Threshold: Enter the threshold limit for this field, over which any values are identified.

• Highlight Color:From the drop-down choice menu, select the color with which the original coloralternates to produce a ‘flashing’ effect.

Area Settings

• Area Stacking: Select whether this area field is stacked. If this field is set to None, then any area fieldsthat have values below fields that follow them in the sequence are ‘hidden’ from view. You cannot havea combination of None and Stacked for performance fields within the same chart panel display

• None: Fields are not stacked and are displayed sequentially

• Stacked: Fields are stacked on top of one another

Note: Stacking is best used when you need to view the total of two or more fields combined. When stacking is used, the vertical axis changes scale to allow an increased view of the display. This should not be misinterpreted as an erroneous reading. Also be aware that the field sequence order can appear to alter the results being viewed. If in doubt, please change the field sequence and review the panel again. See Changing the sequence of display for more information.

Bar Chart parametersThe following parameters are available when defining Bar Charts.

Details






Highlight Settings




Bar Settings

• Bar Stacking: Select whether this bar field is stacked. If this field is set to None, then any bar fields thathave values below fields that follow them in the sequence are ‘hidden’ from view. You cannot have acombination of None and Stacked for performance fields within the same chart panel display




• Side by-Side: Fields are displayed side-by-side



• Bar Style: For Bar Charts only, you can also define the shape of the displayed bar from:

• Arrow

• Diamond

• Ellipse

• Inverted arrow

• Inverted pyramid

• Pyramid

• Rectangle (default setting)

Line ChartsThe following parameters are available when defining Line Charts.

Details






Highlight Settings




Line Settings

• Line Stacking: Select whether this line field is stacked. If this field is set to None, then any area fieldsthat have values below fields that follow them in the sequence are ‘hidden’ from view. You cannot havea combination of None and Stacked for performance fields within the same chart panel display




• Line Width: Select the width of the line when displayed on the chart.

Note: ‘Show Edges’ functionality is incompatible with Line Charts.



Pie ChartsThe following parameters are available when defining Pie Charts.

Details




Highlight Settings panel




You can continue to add further charts and performance data to this chart panel by clicking Add to re-openthe Add Chart dialog and repeating the previous sequence.

Once you have added the charts and performance data that you require, click OK. The chart panel is nowdisplayed to the left of the original panel that was selected when the Add Chart Panel option was initiated.

Adding a List PanelStart by selecting the view to which you want to add a chart panel and select Edit mode.

Note: It is good practise to keep panels of a similar style and performance data together on the same page. However, panels can always be moved at a later point.



From the Edit Tools section on the menu bar, select Panels. A drop-down tool bar is displayed.

Click the Add List Panel icon . The Add List Panel dialog is displayed. The fields on this dialog, definethe performance data information displayed and the format in which this information is presented.

There are three pages contained on this dialog.

• Panel

• Settings

• Advanced

Panel pageThe panel page (screenshot above) is used to define the basic configuration of the panel on the display.From this page, you add, edit and delete the performance collection criteria and the chart formatdefinitions.

CaptionEnter the name of the panel. This is displayed at the top of the panel for reference and is best suited to aaccurate description of the panel contents.



IconFrom the drop-down choice menu, select the icon, that is displayed next to the panel caption. Icons are notunique to the page view. The same icon can be used multiple times on the same page.

Field SelectionDisplays fields that have been defined for performance data reporting on this panel. At least one field mustdefined in order for the panel to be active.

Note: See Adding Performance Fields to a List Chart for more information.

Settings pageThe settings page is used to define additional elements that may enhance the display of performance data.There is only one setting that can be applied when adding or editing a List Panel.

Show Zero ValuesIf checked, this chart displays performance data values that are zero. This can take up space on the actualchart. To remove unwanted zero values from the chart, deselect this option.



Advanced pageThe advanced page of the Add Chart Panel dialog is used to define the amount of performance datadisplayed at any one time and the color schema to be deployed if one is not selected at field level.

Show All RecordsIf selected, all performance data records available for the specified time interval are displayed on this chart.

Show LastIf selected, only the last number of performance data records specified in this field are displayed on thischart for the specified time interval.

Starting ColorIf do not wish to define individual colors for the performance data displayed on this chart, you can define astarting color from which all performance data records on this chart are then derived.

Use the vertical scroll bar to access the starting color that you wish to use. When you are satisfied with yourselection, click the box to the left hand side of the color bar so that a tick mark appears. This is now theselected color from which all performance data records on this chart are then derived.

Adding Performance Fields to a List ChartWhen adding a List Chart, there are no decisions to be made about graphical representation of the data, soyou go straight to selecting the performance data that you wish to be displayed in the list and the ways inwhich you want it displayed.



Field Details settings




Field Display settings




Column Settings

• Heading: Enter the name that you wish to appear at the top of the column to represent the data in thisfield.

• Alignment: Specifies the alignment of performance data displayed in this column. Select from:

• Left

• Center

• Right



• Font styles: Select the type of styling that you wish to apply to the field performance data. Select from:

• Bold

• Italic

• Underline

You can continue to add further performance data to this list panel by clicking Add to re-open the Add Fielddialog and repeating the previous sequence.

Once you have added the performance data that you require, click OK. The list panel is now displayed tothe left of the original panel that was selected when the Add List Panel option was initiated.

Editing a Chart or List PanelUse the Edit Panel functionality (via the Edit Panel icon) to change the contents (but not the charttype) of an existing chart panel.

When editing panels, you can change:

• The caption name of the panel

• The representative icon

• Chart and advanced Settings

• Field colors

• Field sequence

Field definitions and editing procedures are the same used as when Adding a Chart Panel.

Changing the sequence of displayWhen multiple types of chart are being displayed within the same chart panel, it is possible that importantperformance data may be obscured by other data, displayed in a different format.

Performance data is displayed in the order in which it is defined within the chart panel. Therefore if an linechart is defined prior to an area chart, the area chart obscures the line chart. This can be rectified by re-sequencing the order in which the performance fields are displayed.

To change the sequence of display:

1. From the Quick Access toolbar select Edit mode.

2. Click on the chart panel for which you wish to re-sequence the field display.

3. From the toolbar, click the Edit Panel icon . The Edit Chart Panel dialog is displayed.

4. In the Field Selection pane of this dialog, are listed the performance data fields that are currentlydisplayed.

5. Select the field that you wish to move in the display so that it is highlighted and click the correspondingdirection arrow to move the field one place in the chosen direction. (Direction buttons are only availablewhen more than one performance data field is listed and when the direction of movement is possible).

6. Click OK to confirm the move of the selected performance data field.



Editing Performance Data Field definitionsTo edit a performance data field definition, open the required chart panel using the Edit Panel icon andselect the required performance data field from the Field Selection panel. Click Edit within the FieldSelection panel to display the Edit field dialog for the selected field.

You can amend any of the performance data field definitions, except the performance data category.



Deleting a Chart PanelDeleting a chart panel, permanently removes it from the Performance Analyzer GUI.

To delete a chart panel from the current view, select the required panel so that the caption bar ishighlighted. From the menu bar, select Edit and then click the Delete Panel icon on the Edit Toolstoolbar.

You are then prompted to confirm the deletion before the panel is permanently removed from the view.

Clone PanelUsing the clone panel facility is a quick method of adding a chart panel to the current display of thePerformance Analyzer GUI. From the menu bar, select Edit and then click the Clone Panel icon onthe toolbar.

By selecting an existing panel and using the clone panel facility, an exact copy is created on the samedisplay. The contents of this panel can then be edited.

Note: See Editing a Chart or List Panel for more information.


Customizing the default views Creating custom views

Creating custom viewsIn addition to being able to customize current page views within the Performance Analyzer GUI, you canalso create your own custom pages, which are then included in the page views then can be viewedmanually, or on a rolling basis by using auto-switching.

Adding a Page ViewFrom the Performance Analyzer GUI Quick Access bar, select Edit mode. From the Edit Tools toolbar,select Pages > Add Page . The Add Page dialog is displayed.

NameEnter a unique name by which this page view is identified.

IconFrom the drop-down choice menu, select the icon that is used to represent the page view when displayedin the Performance Analyzer GUI toolbar.

Click OK to add the page to the list of available page views. If page auto-switching is active, this page isnow included as part of the view rotation.

At this point the new page view is empty so you must now add chart panels to complete the details on thepage.

Note: See Adding a Chart Panel for more information.

Edit PageThe Edit Page functionality allows you to amend the name and icon details of the page.

Delete PageThe Delete Page functionality allows you to permanently remove a page view from the PerformanceAnalyzer GUI. A confirmation dialog is displayed prior to this action being taken.


Customizing the default views Exiting the program

Exiting the programYou can exit the Performance Analyzer GUI program in one of two ways:

1. By clicking the standard Windows close icon; ‘X’ in the top right corner of the display

2. By selecting the Performance Analyzer GUI Menu options icon and selecting Exit Program from theavailable options.

With either option, if you have made changes to the display that have not been previously saved, a warningmessage is displayed:

If you do not wish to save your changes click Yes to exit the program. If you do wish to save your changes,click No and then either use the Save As option from the Performance Analyzer GUI menu options to savethe view by another name or click the Save icon to save the current settings as default.

Note: Warning. If you do not use the Save As option, any changes made automatically become the default view the next time the Performance Analyzer GUI is opened.


AB/PFMGUIUG/081116

Documents

Performance Analyzer GUI v10.2 User Guide