Queue Dashboard Starter Edition User's Guide
Contents
1. Copyright by Grail Software Solutions 2012 Queue Dashboard Starter Edition User s Guide Explorer Version 1 0 0 Graham Alderson amp Phil Blake Contents PUA CONG O ea e cere paige ects etic er bere E ian eccentric ceeeatr E E E E E A 3 IV SUA AON g A EE EE E E EE E E E E AE E EEE E 4 Minimum ReguirementS trisaeictenuieawinnstisteeer cities i 4 UO Oe d ENVION EN eer a E E E 4 Installing GSS Queue Dashboard in MQ Explorer 7 0 X cccccssseccccssscccceseccceesececeeeceeeeeseeeceusecesseneess 4 Uninstalling GSS Queue Dashboard from MQ Explorer 7 0 x ccccsssccccessececeesecceeeeseceeaesecetseeeceeseees 11 Installing GSS Queue Dashboard in MQ Explorer 7 1 x and 7 5 X esssssssesssssesesrrrssrreresrrrssrrererrrressne 13 Uninstalling GSS Queue Dashboard from MQ Explorer 7 1 x and 7 5 X ccccccesecccesseceeeeseceeeeeceeeeees 16 Starting GSS Queue Dashboard wsssccscesearvcudesauncestncnnnntannncededaarveadenbsustuinedasetannecadedvernauceosiuawsioarweatesnieeeeons 19 Using GSS Que e Dashboard ssiru ES T 19 Gi a2 aoa cae E a A EE E A AE E 20 MENUS arr E E E E E A 21 Fles GSS iae 9011S ea E E E E 21 A ager ci FS 9 S e E EE EA E E E E E A E E E 21 BU ee gi Ps 0 16 oie Biv O ESEA 21 Window gt Show View gt GSS Message CONSUME c ssseccccessccecesecceeesececeeneceeseusecessusecetsunesss 21 Window gt Show View gt GSS Message Generator ccscccccssecccceesececeesececeeeceeseuseceeauseeeteuneses 21 Window2. Find more software by working with the Available Software Sites preferences type filter text Name Version 4 000 Grail Software Solutions update site fore QDepth Starter Edition Explorer feature 1 0 0 Queue Dashboard Starter Edition Explorer feature ea Topic Dashboard Starter Edition Explorer feature Deselect All Liten eae Details Queue Dashboard Starter Edition Explorer feature a The Queue Dashboard feature can be used as an education tool and for an application developer or performance tester to generate watch and _ More Show only the latest versions of available software Hide items that are already installed Group items by category What is already installed Contact all update sites during install to find required software 5 From the Available Software dialog expand the Grail Software Solutions update site node and select the GSS Queue Dashboard Explorer Feature from the drop down list 6 Press the Next button to review the items to be installed 7 Press the Next button again Copyright by Grail Software Solutions 2012 Page 14 Review Licenses Licenses must be reviewed and accepted before the software can be installed License text for Queue Dashboard Starter Edition Explorer feature 1 0 0 End User License Agreement for Grail Software Solutions Queue Dashboard IMPORTANT PLEASE READ THE TERMS AND CONDITIONS OF THIS LICENSE AGREEMENT CAREFULLY BEFORE CONTINUING WITH THIS PR
3. Ignore features not applicable to this environment Automatically select mirrors 4 Press the Finish button Copyright by Grail Software Solutions 2012 Page 7 4 i 000 Grail Software Solutions update site Wt Queue Dashboard Starter Edition Explorer feature 1 0 0 More Into l Topic Dashboard Starter Edition Explorer feature 1 0 0 Wt QDepth Starter Edition Explorer feature 1 0 0 Properties Select Required 1 of 3 selected Show the latest version of a feature only Filter features included in other features on the list 5 From the Updates dialog expand the temp msOu_explorer node and select the GSS Queue Dashboard Starter Edition Explorer feature from the list 6 Press the Next button to see the Feature License dialog Copyright by Grail Software Solutions 2012 Page 8 Feature License Some of the features have license agreements that you need to accept before proceeding End User License Agreement for Grail Software Solutions Queue Dashboard IMPORTANT PLEASE READ THE TERMS AND CONDITIONS OF THIS LICENSE AGREEMENT CAREFULLY BEFORE CONTINUING WITH THIS PROGRAM INSTALL Grail Software Solutions s End User License Agreement EULA is a legal agreement between you either an individual or a single entity and Grail Software Solutions for the Grail Software Solutions software product s identified above which may include associated software components media printed materia
4. gt Show View gt GSS Queue Depth This menu item will give focus to the GSS Queue Depth view If the view is closed then it will be opened Window gt Show View gt Error Log This menu item will give focus to the Eclipse Error Log view If the view is closed then it will be opened Note this view should only be used under the guidance of Grail Software Solutions to help diagnose any problems Copyright by Grail Software Solutions 2012 Page 21 Window gt Reset Perspective This menu item will reset the perspective back to its original state showing the GSS Message Generator view GSS Message Consumer view and GSS Queue Depth view in their default locations Any other opened views will be closed Window gt Navigation Show View Menu This menu item will open the view menu for the view that currently has focus Window gt Navigation Maximize Active View or Editor This menu item will maximize the view that currently has focus Window gt Navigation Minimize Active View or Editor This menu item will minimize the view that currently has focus Window gt Navigation gt Next View This menu item will give focus to the next view from that which currently has focus Window gt Navigation gt Previous View This menu item will give focus to the previous view from that which currently has focus Help Help Contents This menu item will open the Eclipse help Infocenter Help gt Search This menu i
5. and resources at present we have only tested the GSS Queue Dashboard Explorer version in the following environments e Windows 7 SP1 e IBM WebSphere MQ Server 7 0 1 8 7 1 0 0 and 7 5 0 0 e IBM WebSphere MQ SupportPac MSOT 7 0 1 8 and 7 1 0 0 e connecting to a queue manager on IBM WebSphere MQ 7 0 1 8 7 1 0 0 and 7 5 0 0 also on Windows 7 SP1 While we would expect the GSS Queue Dashboard Explorer version to install and run correctly in other environments for example on other versions of Windows or on the various Linux distributions as they are currently untested we would not be able to guarantee this is the case Installing GSS Queue Dashboard in MQ Explorer 7 0 x The file called msOu_explorer zip can be downloaded as part of the MSOU SupportPac from www ibm com support docview wss ers 171 amp uid swg27007198 4 Unzip the file into a temporary location for example c temp msOu_ explorer When installing the MQ Explorer needs to run with Windows administrator privileges Select WebSphere MQ Explorer from the IBM WebSphere MQ folder in the Windows start menu Press right mouse button and choose the option to Run as administrator Make sure MQ Explorer is running in workbench mode open the Preferences dialog select the Window gt Preferences menu item and select the WebSphere MQ Explorer tree node The option in an Eclipse Workbench needs to be selected and then the MQ E
6. gt Show View gt GSS Queue Depth ccccecccccessececcesscceceesececeeseceeceececseuseceseusecetsuneses 21 Window S SHOW View gt Error LOG ccccceseccccesseccccesececcesececcescceceunececeusececeeeceeseesecessunecetsuneees 21 Window gt Reset Perspect VE eee eee eee ee ene ee ree eee eee 22 Window gt Navigation gt SHOW View MenU cccccssseccccsseccccescceceesececeusececeeneceeeeeseeesauecetsuneses 22 Window gt Navigation gt Maximize Active View or Editor ccccssecccssecccesecccseeeeeceeeeeeneneeees 22 Window gt Navigation gt Minimize Active View or ECitOr ccccssscccssecccseeeeseeeeeeceeeeceseneeees 22 Window gt Navigation gt Next VIEW weeccsescivccrcccesionsoasusesencesubnuasancaivesabenmeaevearunsanwnceueshoteesnoavaadst 22 Window gt Navigation gt Previous VIEW cccccssscccssececsecccseccesceesececeeeeeeeeeeeceeeecessecensaeeees 22 FIG FNC OMe AC Sarasa teanatsenense anes anecnetesasuaveasatsantase tenet soaarceccsarucueosancoseuratveceiamasutenerseueaaetserte 22 FON SE ean E 22 PREDS DYA 21061 Sal as ar E E A E 22 Help gt About GSS Queue Dashboard esssssssessseesesrrrsssreresrrrsssrrresrrressreressrerssrereserersseereseeereseere 22 TAEA ea A T E E A ceavacauesed ciomissendiens 24 Copyright by Grail Software Solutions 2012 Page 2 Introduction This document describes the Explorer version of Grail Software Solutions GSS Queue Dashboard Starter Edition
7. tool bar or view menu Closing a view after the Start button has been pressed will also stop the current activity The message generator and consumer in the same Dashboard share the same connection to the queue manager The consumer does not perform a get with wait as this will stop other activity on the connection Each consumer will keep consuming messages until there are no more to consume and then it will wait using the minimum interval before trying again Copyright by Grail Software Solutions 2012 Page 19 The actions of generating and consuming messages have default values and can be controlled by using the sliders on each view changing the time interval between each action and limiting the number of messages Non persistent messages are generated by default The Settings button is explained in the next section Only GSS generated messages will be consumed from the queue when the Start button is pressed on the message consumer view Changing Settings The Settings button on the message generator view shows the following dialog This can be used to change the size of each generated message and to use persistent messages The default is to use non persistent messages An option can also be set to stop generating messages when a queue full condition occurs If this is unselected and a queue full condition is met the next message will be generated after the minimum interval value Message G
8. OGRAM INSTALL Grail Software Solutions s End User License Agreement EULA is a legal agreement between you either an individual or a single entity and Grail Software Solutions for the Grail Software Solutions software product s identified above which may include associated software components media printed materials and online or electronic documentation SOFTWARE PRODUCT By installing copying or otherwise using the SOFTWARE PRODUCT you agree to be bound by the terms of this EULA This license agreement represents the entire agreement concerning the program between you and Grail Software Solutions referred to as licenser and it supersedes any prior proposal representation or understanding between the parties If you do not agree to the terms of this EULA do not install or use the SOFTWARE PRODUCT The SOFTWARE PRODUCT ts protected by copyright laws and international copyright treaties as well as other intellectual property laws and treaties The SOFTWARE PRODUCT is licensed not sold 1 GRANT OF LICENSE O Ido not accept the terms of the license agreement 8 Read and accept the terms of the license agreement 9 Press the Finish button or Cancel to stop the installation Warning You are installing software that contains unsigned content The authenticity 4 or validity of this software cannot be established Do you want to continue with the installation 10 A security warning may be show
9. This version consists of an Eclipse feature to be installed in the IBM WebSphere MQ Explorer There is another client version of GSS Queue Dashboard which can be installed in its own Eclipse alongside a WebSphere MQ Client and that is described in another document GSS Queue Dashboard adds a new context menu contribution to all non system local queues in the Queues content page One or more GSS Queue Dashboards can be launched simultaneously GSS Queue Dashboard can be used to generate PUT messages on a WMQ queue consume GET messages from a WMQ queue showing message PUT and GET rates graphically in various formats The current queue depth is also shown graphically Each action has its own view on the dashboard Only messages generated by GSS Queue Dashboard will be consumed Copyright by Grail Software Solutions 2012 Page 3 Installation Minimum Requirements Minimum requirements to use GSS Queue Dashboard Explorer version is e Windows 7 e IBM WebSphere MQ Server 7 0 1 8 or e IBM WebSphere MQ SupportPac MSOT 7 0 1 8 from www iom com support docview wss rs 171 amp uid swg2 7007198 3 Supported Environments There are many environments that the GSS Queue Dashboard Explorer version could potentially be run in various 7 x versions of the IBM WebSphere MQ Server and 7 x versions of IBM WebSphere MQ SupportPac MSOT and the operating systems they both support As a small company with limited time
10. eature_1 0 0 10 Press the Install or Install All button Copyright by Grail Software Solutions 2012 Page 10 You will need to restart the Eclipse SDK for the changes to take effect Would you like to restart now 11 Press the Yes button to restart the MQ Explorer Uninstalling GSS Queue Dashboard from MQ Explorer 7 0 x When uninstalling the MQ Explorer needs to run with Windows administrator privileges Select WebSphere MQ Explorer from the IBM WebSphere MQ folder in the Windows start menu Press right mouse button and choose the option to Run as administrator Make sure MQ Explorer is running in workbench mode open the Preferences dialog select the Window gt Preferences menu item and check the WebSphere MQ Explorer tree node The option in an Eclipse Workbench needs to be selected and then the MQ Explorer needs to be restarted Select the Help gt Software Updates gt Manage Configuration menu item and expand the Eclipse SDK node to show all features DS OOOO O O OOO a Eclipse SDK lit Eclipse Project SDK 3 3 2 R33x_r20071022 7M7J7 Wt Eclipse Project SDK Translations 3 3 1 v2007092 ih sic abe aici Traconi R Queue Dashboard Starter Edition Explorer feature The Queue Dashboard feature can it Graphical Editing Framework 3 3 1 v20070814 be used as an education tool and for an application deweloper or performance tester Wt Graphical Edi
11. ect You es P may try to apply the changes without restarting but this may cause errors Restat Now __ NotNow Apply Changes Now 5 Press the Restart Now button to restart the MQ Explorer Note uninstalling a feature from Eclipse does not remove the jar files from the plugin sub directory that make up the feature and it is recommended these files are not deleted Copyright by Grail Software Solutions 2012 Page 18 Starting GSS Queue Dashboard Open the Queues content page on the MQ Explorer and select a local queue Press the right mouse button to show a context menu and select GSS Dashboard This will open the GSS Queue Dashboard in a new window G55 Queue Dashboard Q2 on QM2 Srn eein File Window Help m GSS Message Generator ss Fir Booey EO GSS Queue Depth ii Minimum interval between each message generated msec Fi ay Y 100 LOO00 Limit the number of messages generated 10 igid Start 100 Limit the number of messages consumed 10 10000 Stn Using GSS Queue Dashboard Initially the GSS Queue Dashboard contains 3 views 1 to generate messages PUT on the selected queue 1 to consume messages GET from the queue and a third view showing the current queue depth Each view has a default graphical representation of the action and this can easily be changed by selecting a different icon on the view
12. enerator Settings g g Message size bytes 100 Copyright by Grail Software Solutions 2012 Page 20 Menus The GSS Queue Dashboard menu bar has 3 main menus File Window and Help File gt GSS trace gt Options This menu item will be enabled if there is no location defined for the GSS trace file or GSS trace has not been started A dialog is shown to define the location for the GSS trace file and to choose whether to start GSS trace the next time the GSS Queue Dashboard is started Note that GSS trace should only be used under the guidance of Grail Software Solutions to help diagnose any problems File GSS trace gt Start This menu item will be enabled if a location has been defined for the GSS trace file and GSS trace has not been started Note that GSS trace should only be used under the guidance of Grail Software Solutions to help diagnose any problems File GSS trace gt Stop This menu item will be enabled if GSS trace has been started Note that GSS trace should only be used under the guidance of Grail Software Solutions to help diagnose any problems Window gt Show View gt GSS Message Consumer This menu item will give focus to the GSS Message Consumer view If the view is closed then it will be opened Window gt Show View gt GSS Message Generator This menu item will give focus to the GSS Message Generator view If the view is closed then it will be opened Window
13. ing is a registered trademark of Linus Torvalds in the U S and other countries Linux Copyright by Grail Software Solutions 2012 Page 24
14. ls and online or electronic documentation SOFTWARE PRODUCT By installing copying or otherwise using the SOFTWARE PRODUCT you agree to be bound by the terms of this EULA This license agreement represents the entire agreement concerning the program between you and Grail C Ido not accept the terms in the license agreement 7 Read and accept the terms of the license agreement 8 Press the Next button Copyright by Grail Software Solutions 2012 Page 9 a Installation The following features will be installed You can select a feature and change the location where the feature will be installed Features to install Feature Mame Feature Version Feature Size Installation Directory Lar Queue Dashboard 1 0 0 Unknown C Program Files x86 IBM We Install Location Prograrm Files x66 IBM WebSphere MQ eclipseSDES3 eclip Change Location Required space Unknown Free space 600 55 GB 9 Press the Finish button or Cancel to stop the installation Feature Verification gb Warning You are about to install an unsigned feature You may choose to install the feature or cancel its installation This feature has not been digitally signed The provider of this feature cannot be verified Feature name Queue Dashboard Starter Edition Explorer feature Feature Identifier com gss dashboard queue server feature_1 0 0 Provider GSS File Identifier com gss dashboard queue server f
15. n saying Warning you are installing software that contains unsigned content Press the OK button to continue the installation or Cancel to quit the installation Ci You will need to restart Eclipse SDK for the installation changes to take effect You SP may try to apply the changes without restarting but this may cause errors Copyright by Grail Software Solutions 2012 Page 15 11 Press the Restart Now button to restart the MQ Explorer Uninstalling GSS Queue Dashboard from MQ Explorer 7 1 x and 7 5 x When uninstalling the MQ Explorer needs to run with Windows administrator privileges Select WebSphere MQ Explorer from the IBM WebSphere MQ folder in the Windows start menu Press right mouse button and choose the option to Run as administrator Select the Help gt Install New Software menu item Available Software Select a site or enter the location of a site 8 Work with j type or select a site Find more software by working with the Available Software Sites preferences type filter text Name Version Gi There is no site selected Details Show only the latest versions of available software Hide t r 1a Treacy installed Group items by category Vinat is already installed Contact all update sites during install to find required software 1 Press the link in What is already installed Copyright by Grail Software Solu
16. plorer zip can be downloaded as part of the MSOU SupportPac from www iom com support docview wss rs 171 amp uid swg2 7007198 4 Unzip the file into a temporary location for example c temp msOu_ explorer When installing the MQ Explorer needs to run with Windows administrator privileges Select WebSphere MQ Explorer from the IBM WebSphere MQ folder in the Windows start menu Press right mouse button and choose the option to Run as administrator Select the Help gt Install New Software menu item Install Available Software Select a site or enter the location of a site Work ert type or select a site Find more software by working with the Available Software Sites preferences type filter text Name Version E G There is no site selected Select All Deselect All Details Show only the latest versions of available software C Hide iterns that are already installed Group items by category hat is already installed Contact all update sites during install to find required software 1 Press the Add button 2 Press the Local button on the Add Repository dialog 3 Select the directory containing the GSS Queue Dashboard site xml file for example c temp msOu_ explorer You do not need to enter anything in the Name field Copyright by Grail Software Solutions 2012 Page 13 4 Press the OK button Work with file C temp msQu_explorer
17. tem will open the Eclipse help tray view with a search field Help Dynamic Help This menu item will open the Eclipse help tray and show the online help for the currently selected view Help About GSS Queue Dashboard This menu item displays a dialog providing information about the MQ Explorer and the GSS Queue Dashboard The appearance of this dialog can vary with the version of MQ Explorer installed for example on MQ Explorer 7 0 1 8 it looks like this Copyright by Grail Software Solutions 2012 Page 22 Eclipse SDK Version 3 3 1 1 Build id M20071023 1652 ic Copyright Eclipse contributors and others 2000 2007 All rights reserved Visit http www eclipse org platform This product includes software developed by the Apache Software Foundation http www apache org IBM WebSphere MQ Explorer Version 7 1 0 0 c Copyright IBM Corporation and other s 1994 2011 All Rights Reserved Visit http www ibm com webspheremg This product is Built on Eclipse http www eclipse org Copyright by Grail Software Solutions 2012 Page 23 Trademarks The following are trademarks of International Business Machines Corporation registered in many jurisdictions worldwide IBM WebSphere The following is a trademark of Microsoft Corporation registered in many jurisdictions worldwide Windows 7 The following are trademarks of Eclipse Foundation Inc Eclipse Built on Eclipse The follow
18. ting Framework Translations 3 3 1 to generate watch and trigger event activity on a selected queue Wit Graphical Editing Framework Translations 3 3 1 Wt IBM WebSphere MQ Explorer 7 0 1 8 Available Tasks Wt QDepth Starter Edition Explorer feature 1 0 0 Disable 3 Queue Dashboard Starter Editon Explores feat You can enable or disable the functionality of a feature The feature is not removed Witt Topic Dashboard Starter Edition Explorer featui by this action tot WebSphere MQ Explorer 7 0 1 0 Wt WebSphere MQ Explorer help 7 0 1 8 Queue Dashboard Starter Edition Explorer feature 1 0 0 Show Properties View properties of the feature such as version provider name license agreement etc Queue Dashboard Starter Edition Explorer feature 1 0 0 1 Select Queue Dashboard Starter Edition Explorer feature press right mouse button and select the Uninstall menu item Copyright by Grail Software Solutions 2012 Page 11 2 You will need to restart the Eclipse SDE for the changes to take effect Would you like to restart now Se ee 3 Press the Yes to restart the MQ Explorer Note uninstalling a feature from Eclipse does not remove the jar files from the plugin sub directory that make up the feature and it is recommended these files are not deleted Copyright by Grail Software Solutions 2012 Page 12 Installing GSS Queue Dashboard in MQ Explorer 7 1 x and 7 5 x The file called msOu_ex
19. tions 2012 Page 16 Installed Software Name Version Id a G MQ Explorer 7 1 0 201110191414 com ibm mq explorer ui rcp Re 7 1 0 201110191414 com ibm mq explorer ui rcp Re Wt Eclipse Platform Subset for MQ Explorer 7 1 0 2011101914135 com ibm mq eclpse platform Wt Eclipse Platform Subset for MQ Explorer Translations Gre 7 1 0 201110191413 com ibm mq eclipse platform Wt Eclipse Platform Subset for MQ Explorer Translations Gre 7 1 0 201110191413 com ibm mq eclipse platform Wt WebSphere MQ Explorer 7 1 0 201110191415 com ibm mq explorer feature f Wt WebSphere MQ Explorer Translations 71 0 20111019141 com Jbm mg explorer teature r Queue Dashboard Starter Edition Explorer feature D com gss dashboard queue sen Queue Dashboard Starter Edition Explorer feature The Queue Dashboard feature can be used as an education tool and for an application developer or performance tester to generate watch and trigger event activity on a selected queue 2 Select the GSS Queue Dashboard Explorer feature 3 Press the Uninstall button Uninstall Details Review and confirm the iteme to be uninstalled Name Version Lah Queue Dashboard Starter Edition Explorer feature 1 0 0 com gss dasr 4 Press the Finish button to uninstall or Cancel to stop uninstall Copyright by Grail Software Solutions 2012 Page 17 ssov O gh You will need to restart Eclipse SDK for the installation changes to take eff
20. xplorer needs to be restarted Select the Help gt Software Updates gt Find and Install menu item Copyright by Grail Software Solutions 2012 Page 4 Feature Updates Choose the way you want to search for features to install Search for updates of the currently installed features Select this option if you want to search for updates of the features you already have installed Select this option if you want to install new features from existing or new update sites Some sites may already be available You can add new update site URLs to the search 1 Select Search for new features to install and press the Next button Copyright by Grail Software Solutions 2012 Page 5 Update sites to visit Select update sites to visit while looking for new features Sites to include in search srl Europa Discovery Site J Graphical Editing Framework GEF Update Site Ignore features not applicable to this environment Automatically select mirrors 2 Press the New Local Site button 3 Select the directory containing the GSS Queue Dashboard site xml file for example c temp msOu_ explorer Copyright by Grail Software Solutions 2012 Page 6 Update sites to visit Select update sites to visit while looking for new features Sites to include in search j Europa Discovery Site Graphical Editing Framework GEF Update Site ml temp mesQu_explorer H The Eclipse Project Updates
Download Pdf Manuals
Related Search