IBM Tivoli Monitoring for Business Integration. User s Guide. Version SC

Size: px
Start display at page:

Download "IBM Tivoli Monitoring for Business Integration. User s Guide. Version SC"

Transcription

1 IBM Tioli Monitoring for Business Integration User s Guide Version SC

2

3 IBM Tioli Monitoring for Business Integration User s Guide Version SC

4 Note Before using this information and the product it supports, read the information Appendix F, Notices, on page 371. First Edition (October 2003) This edition applies to ersion of IBM Tioli Monitoring for Business Integration: WebSphere MQ, ersion of IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator, and ersion of IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation All rights resered. US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Figures ix Tables xi About this guide xiii Who should read this guide xiii What this guide contains xiii Publications xi IBM Tioli Monitoring for Business Integration library xi Prerequisite publications xiii Related publications xiii Accessing publications online xix Ordering publications xix Accessibility xx Contacting software support xx Conentions used in this guide xx Typeface conentions xx Operating system-dependent ariables and paths xxi Tioli command syntax xxi Part 1. Standard monitoring procedures for all IBM Tioli Monitoring for Business Integration software Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration... 3 Tioli monitoring enironment Tioli management region Components of a Tioli monitoring enironment.6 IBM Tioli Monitoring for Business Integration: WebSphere MQ Managing WebSphere MQ resources IBM Tioli Monitoring for Business Integration: WebSphere MQ for proxy mode z/os Managing WebSphere MQ resources on a proxy mode z/os system Managing WebSphere MQ on multiple proxy mode z/os systems IBM Tioli Monitoring for Business Integration: WebSphere MQ Message Manager IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow Integration of WebSphere MQ monitoring and WebSphere MQ Integrator monitoring IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator WebSphere MQ Integrator enironment Managing WebSphere MQ Integrator resources 21 IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer WebSphere InterChange Serer enironment..23 Managing and Monitoring WebSphere InterChange Serer Tools for managing IBM Tioli Monitoring for Business Integration resources Administrators Authorization roles Managed resources and endpoints User interface options Chapter 2. Setting up IBM Tioli Monitoring for Business Integration.. 31 Accessing the Tioli Management Framework enironment Setting authorization roles Creating profile managers and profiles Subscribing resources to profile managers Adding a default resource model to a profile...41 Distributing profiles Rerunning failed profile distributions Chapter 3. Working with resource models Resource model concepts Adding a custom resource model to a profile...55 Customizing indications and eents Specifying tasks for an indication Sending a notice to administrators when an eent occurs Customizing parameters Customizing a schedule for a resource model...64 Customizing data logging information Managing profiles and resource models at endpoints 69 Managing IBM Tioli monitoring on gateways...70 Determining which resource models hae been distributed to endpoints Determining which resource models are running on endpoints Chapter 4. Viewing resource model results with the IBM Tioli Monitoring Web Health Console Resource health Connecting the IBM Tioli Monitoring Web Health Console Chapter 5. Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse Tioli Enterprise Data Warehouse oeriew...76 Working with users and user groups About users and user groups Tioli Enterprise Data Warehouse roles Accessing the IBM Console Creating an IBM Console user Copyright IBM Corp iii

6 Assigning roles to a user Creating a user group Assigning users to a user group Assigning user groups to a data mart Managing Tioli Enterprise Data Warehouse reports 83 Running reports Scheduling reports to run automatically Modifying default settings for reports Creating reports Prepackaged reports Prepackaged reports for IBM Tioli Monitoring for Business Integration: WebSphere MQ Prepackaged reports for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Star schemas Data marts and reports Prepackaged reports for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Chapter 6. Integrating with IBM Tioli Enterprise Console IBM Tioli Enterprise Console oeriew Configuring the eent serer Configuring the Tioli Enterprise Console eent groups Configuring the WebSphere MQ eent adapter Installing the MQSI eent adapter Configuring the MQSI eent adapter Configuring endpoints for MQ Integrator log file adapter support Installing the MQ Integrator log file message formats Starting and stopping a WebSphere MQ eent adapter Starting and stopping the MQSI eent adapter..112 Starting and stopping the WebSphere MQ Integrator log file adapter Filtering eents Running a task on an eent Chapter 7. Integrating with IBM Tioli Business Systems Manager IBM Tioli Business Systems Manager oeriew 120 Integrating with IBM Tioli Business Systems Manager Creating the WebSphere MQ task libraries for IBM Tioli Business Systems Manager Customizing the Line of Business iew for WebSphere MQ resources Discoering WebSphere MQ resources for IBM Tioli Business Systems Manager Discoering WebSphere MQ Integrator resources for IBM Tioli Business Systems Manager Naigating to resources Running tasks in the Tioli Business Systems Manager console Deleting resources Uninstalling the integration with IBM Tioli Business Systems Manager Chapter 8. Working with tasks and jobs Tasks and jobs oeriew Enabling remote administration for WebSphere MQ 142 Running a task Changing the timeout alue for a WebSphere MQ icon context menu task Customizing a task Creating a job Running a job Scheduling a job Part 2. IBM Tioli Monitoring for Business Integration: WebSphere MQ Chapter 9. Quick-reference guide for IBM Tioli Monitoring for Business Integration: WebSphere MQ Chapter 10. Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ Changing the mapping of the irtual user ID for WebSphere MQ Creating a management domain Populating the management domains Chapter 11. Installing WebSphere MQ software Creating a WebSphere MQ software package Distributing WebSphere MQ software Verifying the installation of WebSphere MQ software Chapter 12. Managing WebSphere MQ proxy mode z/os SMF records Understanding how the Statistics Eent Adapter works Starting the Statistics Eent Adapter Controlling statistics eents Chapter 13. Managing messages with IBM Tioli Monitoring for Business Integration: WebSphere MQ Message Manager Launching Message Manager Using Message Manager help Browsing messages Copying and Moing messages Deleting Messages Importing data from a file to a message Exporting data from a message to a file i IBM Tioli Monitoring for Business Integration: User s Guide

7 Chapter 14. Working with Workflow serers and queue managers Workflow oeriew Accessing Workflow tasks Setting the ADMIN password Starting the Workflow Admin Serice Stopping the Workflow Admin Serice Using the Workflow Serices window Checking the Workflow Configuration Starting selected Workflow serices Stopping selected Workflow serices Enabling monitoring Disabling monitoring Part 3. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Chapter 15. Quick-reference guide for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator 217 Chapter 16. Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Creating IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects Configuring performance monitoring Installing the Tioli MQSI performance database serice Installing the TioliMonitor node on brokers Installing the TioliMonitor node on Control Centers Inserting and deploying the TioliMonitor node 224 Uninstalling the Tioli performance database serice Chapter 17. Working with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects Working with objects Desktop icons Menu structure Remoing Tioli objects Using the Operation group Using the Execution Groups window Using the Configuration group Using the Monitoring group Using the Diagnostics group Using the Members option on the Configuration Manager icon Part 4. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Chapter 18. Quick-reference guide for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Chapter 19. Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer oeriew Tioli Management Framework Defining your InterChange Serers to Tioli Understanding the SNMP Agent Viewing Information about your InterChange Serers Taking actions on your InterChange Serers Understanding the resource model Deploying the resource model Recoery tasks Using IBM Tioli Enterprise Console with InterChange Serer eents Use in interconnected Tioli regions Understanding Tioli object locations Reconfiguration options Using relationship information Discoering InterChange Serers Defining InterChange Serers manually Configuring SNMP Agents Setting SNMP Community Names Discoering adapter agents Defining Adapter Agents manually Chapter 20. Viewing information related to InterChange Serers Checking status Viewing queue managers Opening the profiles window and accessing operations for the profiles Chapter 21. Working with SNMP agents Viewing SNMP agent properties Retrieing SNMP agent logs Starting SNMP agents Stopping SNMP agents Changing the SNMP host Chapter 22. Working with InterChange Serers Viewing the properties of InterChange Serers Starting InterChange Serers Stopping InterChange Serers Enabling resource models Disabling resource models Changing configuration files Changing hosts Contents

8 Chapter 23. Working with adapter agents Viewing adapter agent properties Retrieing adapter agent logs Starting adapter agents Stopping adapter agents Chapter 24. Working with adapter controllers and collaborations Opening the Adapter Controllers window Starting adapter controllers Pausing adapter controllers Stopping adapter controllers Opening the Collaborations window Starting collaborations Pausing collaborations Stopping collaborations Shutting down collaborations Chapter 25. Working with log and trace files for InterChange Serers Opening a list of InterChange Serer log or trace files Retrieing an InterChange Serer log file or trace file Opening the Tioli Log File window Retrieing Tioli log files Deleting Tioli log files Chapter 26. Working with Tioli configuration settings for WebSphere InterChange Serers Reestablishing Tioli Endpoints Setting data proider trace leels Part 5. Appendixes Appendix A. Authorization roles quick reference Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere MQ Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Appendix B. Context menu quick reference Context menus for IBM Tioli Monitoring for Business Integration: WebSphere MQ Monitoring for WebSphere MQ icon context menu tasks Management domain icon context menu tasks 325 Queue manager icon (running status) context menu tasks Queue manager icon (stopped status) context menu tasks Queue Manager Control Center tasks Task menu paths for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Menus for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Appendix C. Eent classes and rules 339 Eent classes and rules for IBM Tioli Monitoring for Business Integration: WebSphere MQ Eent classes Eent adapter operational eent classes WebSphere MQ eent classes MQ Workflow component eent classes Resource model eent classes WebSphere MQ integration support for Tioli Business Systems Manager eent class Eent classes for proxy mode z/os messages 345 Eent classes for proxy mode z/os SMF records Eent rules Eent rules for IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow component Eent classes and rules for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator 352 Eent classes MQSI Eent Adapter classes Tioli log file adapter classes Resource model classes Eent slots MQSI Eent Adapter slots Tioli log file adapter eent slots Resource model eent slots Rules for resource models Rules for eents Eent classes and rules for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Eent classes Eent rules Eent scripts Configuring the eent serer Eent console tasks Appendix D. Tioli NetView for proxy mode z/os Message automation IHSMQMGR automation table IHSMAUTO automation table IHSM040I CLIST IHSMSSCH CLIST IHSMSTEC CLIST IHSMMONQ CLIST Appendix E. Accessibility Naigating the interface using the keyboard Magnifying what is displayed on the screen Appendix F. Notices Trademarks i IBM Tioli Monitoring for Business Integration: User s Guide

9 Index Contents ii

10 iii IBM Tioli Monitoring for Business Integration: User s Guide

11 Figures 1. IBM Tioli Monitoring for Business Integration: WebSphere MQ for proxy mode z/os task and resource model flow Managing WebSphere MQ on Multiple proxy mode z/os Systems Aailability Status for Queue Managers Daily report example Maximum Outstanding Messages for Queues Daily report example Configure Eent Serer window for IBM Tioli Monitoring for Business Integration: WebSphere MQ Configure Eent Serer window for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Configure Eent Serer window for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Configure Eent Adapter window Task library window Execute Task window Destination for Task Output window Icon context menu Policy Region: Monitoring for WebSphere MQ window Icon context menu for a management domain Queue Manager Control Center window Action menu aailable from the Queue Manager Control Center window Queue Information Center window Execute task window Task argument window Window for saing the argument Create Job window Destination for Task Output window Add Scheduled Job window Set Retry/Cancel/Restriction Options window How the Statistics Eent Adapter works Message Manager console Add Definition window in Message Manager Message View window with Message Data option highlighted Policy Region: Monitoring for WebSphere MQ window Profile Manager window for MQWF Resource Models Queue manager icon context menu Queue Manager icon context menu of Workflow tasks Workflow menus aailable from the Queue Manager Control Center window Enter ADMIN Password window Workflow Serices window Operation menu Configuration menu Monitoring menu Diagnostic menu Create WICSerer window Create WICSAdapterAgent window Adapter Controllers window Collaborations window Set Data Proider Trace Leel window IHSMQMGR automation table IHSMSSCH CLIST IHSMSTEC and IHSMMONQ CLISTs 367 Copyright IBM Corp ix

12 x IBM Tioli Monitoring for Business Integration: User s Guide

13 Tables 1. Setting up resource models Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere MQ Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Working with resource models Viewing resource model results in the Web Health Console Health determination example Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse Default time filter names and alues Resource models associated with the prepackaged reports Setting up and using IBM Tioli Enterprise Console with IBM Tioli Monitoring for Business Integration software Eent filter examples for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Platform support for MQSeries TEC tasks Tioli Eent Console tasks and eents for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Integrating IBM Tioli Monitoring for Business Integration with IBM Tioli Business Systems Manager WebSphere MQ support with IBM Tioli Business Systems Manager Manager queue manager tasks WebSphere MQ support for Tioli Business Systems Manager queue tasks WebSphere MQ support for Tioli Business Systems Manager channel tasks WebSphere MQ integration support for Tioli Business Systems Manager operational tasks for all objects WebSphere MQ integration support for Tioli Business Systems Manager broker tasks Working with tasks and jobs Quick-reference information for getting started with IBM Tioli Monitoring for Business Integration: WebSphere MQ Configuring IBM Tioli Monitoring for Business Integration: WebSphere MQ Virtual user ID mapping for operating systems for IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere MQ management domain icon IBM Tioli Monitoring for Business Integration: WebSphere MQ queue manager icon IBM Tioli Monitoring for Business Integration: WebSphere MQ icon status Installing WebSphere MQ software tasks Managing WebSphere MQ proxy mode z/os SMF records Setting up and using Message Manager Working with Workflow serers and queue managers Quick-reference information for getting started with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Methods to create Tioli objects for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Guidelines for setting up performance monitoring for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Working with objects in IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Broker icon states Configuration Manager icon states User Name Serer icon states Quick-reference information for getting started with IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Configuring IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Viewing information related to InterChange Serers Status information reported for each type of WebSphere InterChange Serer resource Working with SNMP agents Working with InterChange Serers Working with adapter agents Working with adapter controllers and collaborations Working with log and trace files for InterChange Serers Working with Tioli configuration settings for WebSphere InterChange Serers Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere MQ tasks Monitoring for WebSphere MQ icon context menu tasks Management domain icon context menu tasks 326 Copyright IBM Corp xi

14 53. Queue manager icon (running status) context menu tasks Queue manager icon (stopped status) context menu tasks Queue manager control center tasks Task menu paths quick reference for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Task menu paths quick reference for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Eent adapter operational eent classes for IBM Tioli Monitoring for Business Integration: WebSphere MQ WebSphere MQ eent classes for IBM Tioli Monitoring for Business Integration: WebSphere MQ Resource model eent classes for IBM Tioli Monitoring for Business Integration: WebSphere MQ Eent classes for proxy mode z/os messages for IBM Tioli Monitoring for Business Integration: WebSphere MQ Eent classes for proxy mode z/os SMF records for IBM Tioli Monitoring for Business Integration: WebSphere MQ Eent rules for IBM Tioli Monitoring for Business Integration: WebSphere MQ MQSI Eent Adapter classes and their descriptions Tioli eent class descriptions for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Resource model classes and their descriptions for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator MQSI Eent Adapter slots and their descriptions for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Tioli log file adapter eent slots and their descriptions for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Resource model eent slots and their descriptions for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Eent classes for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Eent rules for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer WICS Eent Serer tasks xii IBM Tioli Monitoring for Business Integration: User s Guide

15 About this guide Who should read this guide The IBM Tioli Monitoring for Business Integration User s Guide proides information about using each of the IBM Tioli Monitoring for Business Integration components: IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer This guide describes how to manage the resources for each component using the tasks and resource models that the IBM Tioli Monitoring for Business Integration components proide. This guide is for system administrators who monitor and manage WebSphere MQ, WebSphere MQ Workflow, WebSphere MQ Integrator, and WebSphere InterChange Serer resources. Readers should be familiar with the following topics: Tioli management software UNIX operating systems Windows operating systems z/os operating systems Databases IBM WebSphere MQ What this guide contains IBM WebSphere MQ Integrator IBM WebSphere InterChange Serer Tioli Enterprise Data Warehouse IBM Tioli Enterprise Console IBM Tioli Business Systems Manager WebSphere MQ Workflow This guide contains the following sections: Part 1 Standard monitoring procedures Part 1 contains the following chapters, which are applicable to eery IBM Tioli Monitoring for Business Integration component: Chapter 1, Oeriew of IBM Tioli Monitoring for Business Integration, on page 3 Proides an introduction to the IBM Tioli Monitoring for Business Integration product. Chapter 2, Setting up IBM Tioli Monitoring for Business Integration, on page 31 Copyright IBM Corp xiii

16 Describes how to set up IBM Tioli Monitoring to monitor resources for each of the components. The procedures described in this chapter are not required if you are using the resource models with default configurations and if you distribute the resource models when you discoer or create the resources you want to manage. Chapter 3, Working with resource models, on page 49 Describes how to customize resource models. Chapter 4, Viewing resource model results with the IBM Tioli Monitoring Web Health Console, on page 73 Proides an oeriew of the IBM Tioli Monitoring Management Console. Chapter 5, Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse, on page 75 Describes how to work with Tioli Enterprise Data Warehouse, and describes the prepackaged reports that each IBM Tioli Monitoring for Business Integration component proides. Chapter 6, Integrating with IBM Tioli Enterprise Console, on page 93 Describes how to configure the eent serer, eent consoles, and the eent adapters for each of the IBM Tioli Monitoring for Business Integration components. Chapter 7, Integrating with IBM Tioli Business Systems Manager, on page 119 Describes how to configure the integration of IBM Tioli Monitoring for Business Integration components with IBM Tioli Business Systems Manager and how to manage resources from a IBM Tioli Business Systems Manager workstation. Chapter 8, Working with tasks and jobs, on page 141 Describes how to run IBM Tioli Monitoring for Business Integration tasks. Part 2 IBM Tioli Monitoring for Business Integration: WebSphere MQ Part 2 contains the following chapters, which are applicable only to the IBM Tioli Monitoring for Business Integration: WebSphere MQ component: Chapter 9, Quick-reference guide for IBM Tioli Monitoring for Business Integration: WebSphere MQ, on page 171 Proides a quick-reference table of the setup procedures you must perform before you can use IBM Tioli Monitoring for Business Integration: WebSphere MQ. Chapter 10, Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ, on page 173 Describes the information you need to get started and describes the tasks you must complete before you can use IBM Tioli Monitoring for Business Integration: WebSphere MQ. Chapter 11, Installing WebSphere MQ software, on page 181 Describes how to create WebSphere MQ software packages to install or upgrade WebSphere MQ software, and describes how to erify the installation. Chapter 12, Managing WebSphere MQ proxy mode z/os SMF records, on page 185 Describes how to use the Statistics Eent Adapter to monitor WebSphere MQ proxy mode z/os System Management Facilities (SMF) statistics and accounting records. Chapter 13, Managing messages with IBM Tioli Monitoring for Business Integration: WebSphere MQ Message Manager, on page 189 xi IBM Tioli Monitoring for Business Integration: User s Guide

17 Describes how to use Message Manager to manage WebSphere MQ messages on a queue. Chapter 14, Working with Workflow serers and queue managers, on page 199 Describes how to use the Workflow features in IBM Tioli Monitoring for Business Integration: WebSphere MQ to manage serices and monitor workflow processes. Part 3 IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Part 3 contains the following chapters, which are applicable only to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator component: Chapter 15, Quick-reference guide for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator, on page 217 Proides a quick-reference table of the setup procedures you must perform before you can use IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. Chapter 16, Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator, on page 219 Describes the procedures required to set up IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. Chapter 17, Working with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects, on page 227 Proides information about using the desktop icons for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. Part 4 IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Part 4 contains the following chapters, which are applicable only to the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer component: Chapter 18, Quick-reference guide for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer, on page 241 Proides a quick-reference table of the setup procedures you must perform before you can use IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. Chapter 19, Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer, on page 243 Describes the procedures required to set up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Chapter 20, Viewing information related to InterChange Serers, on page 265 Proides information about procedures for iewing information about InterChange Serers and resources. Chapter 21, Working with SNMP agents, on page 271 Proides information about the SNMP agent and procedures for working with it. Chapter 22, Working with InterChange Serers, on page 277 Proides information about working with InterChange Serers and InterChange Serer resources. Chapter 23, Working with adapter agents, on page 287 Proides information about adapter agents and procedures for working with them. About this guide x

18 Chapter 24, Working with adapter controllers and collaborations, on page 293 Proides information about adapter controllers and collaborations and procedures for working with them. Chapter 25, Working with log and trace files for InterChange Serers, on page 303 Proides information about InterChange Serer log and trace files and Tioli log and trace files. Chapter 26, Working with Tioli configuration settings for WebSphere InterChange Serers, on page 309 Proides information about Tioli configuration settings. Part 5 Appendixes Part 5 contains the following appendixes. Some appendixes are applicable to each of the IBM Tioli Monitoring for Business Integration components. Others are applicable to all components. Appendix A, Authorization roles quick reference, on page 315 Describes the authorization roles that are required for the tasks in each IBM Tioli Monitoring for Business Integration component. Appendix B, Context menu quick reference, on page 325 Proides a summary of the authorization roles required to run the tasks in each IBM Tioli Monitoring for Business Integration component. Appendix C, Eent classes and rules, on page 339 Describes the eent classes and rules for each IBM Tioli Monitoring for Business Integration component. Appendix D, Tioli NetView for proxy mode z/os Message automation, on page 365 Proides examples of write-to-operator (WTO) message automation programs for IBM Tioli Monitoring for Business Integration: WebSphere MQ. Appendix E, Accessibility, on page 369 Describes the accessibility features in all IBM Tioli Monitoring for Business Integration components. Appendix F, Notices, on page 371 Proides IBM and Tioli notices and trademark information as it applies to all IBM Tioli Monitoring for Business Integration components. Publications This section lists publications in the IBM Tioli Monitoring for Business Integration library and related documents. It also describes how to access Tioli publications online and how to order Tioli publications. IBM Tioli Monitoring for Business Integration library The following documents are aailable in the IBM Tioli Monitoring for Business Integration library: IBM Tioli Monitoring for Business Integration IBM Tioli Monitoring for Business Integration: Readme First, SC Proides information on where to find all of the IBM Tioli Monitoring for Business Integration documentation, including the titles and locations of all documentation. xi IBM Tioli Monitoring for Business Integration: User s Guide

19 IBM Tioli Monitoring for Business Integration Installation and Setup Guide, SC Proides information about installing each of the IBM Tioli Monitoring for Business Integration components. IBM Tioli Monitoring for Business Integration User s Guide, SC Proides information about how to use each IBM Tioli Monitoring for Business Integration component to manage resources. IBM Tioli Monitoring for Business Integration Problem Determination Guide, SC Proides information and messages to assist users with troubleshooting problems with the software. IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide, SC Proides information about the tasks and resource models that IBM Tioli Monitoring for Business Integration: WebSphere MQ proides. IBM Tioli Monitoring for Business Integration: WebSphere MQ Warehouse Enablement Pack Implementation Guide, SC Proides information that helps users deploy and use Tioli Enterprise Data Warehouse with IBM Tioli Monitoring for Business Integration: WebSphere MQ. IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow Warehouse Enablement Pack Implementation Guide, SC Proides information that helps users deploy and use Tioli Enterprise Data Warehouse with the Workflow function in IBM Tioli Monitoring for Business Integration: WebSphere MQ. Program Directory for IBM Tioli Monitoring for Business Integration: WebSphere MQ for z/os, GI Proides information about installing IBM Tioli Monitoring for Business Integration: WebSphere MQfor z/os. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide, SC Proides information about the resource models, tasks, and commands that IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Warehouse Enablement Pack Implementation Guide, SC Proides information that helps users deploy and use Tioli Enterprise Data Warehouse with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. Program Directory for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator for z/os, GI Proides information about installing IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator for z/os. IBM Tioli Monitoring for Business Integration Release Notes, GI Proides information about system requirements and specific information related to each component of the IBM Tioli Monitoring for Business Integration product. About this guide xii

20 IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Limitations and Workarounds Supplement, SC Proides information about problems that might occur, as well as customer issues that hae been resoled. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide, SC Proides information about the tasks and resource models that IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides. IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Warehouse Enablement Pack Implementation Guide, SC Proides information that helps users deploy and use Tioli Enterprise Data Warehouse with IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. Prerequisite publications To use the information in this guide effectiely, you must hae some prerequisite knowledge, which you can get from the following guides: IBM Tioli Monitoring User s Guide, SC Proides an oeriew of IBM Tioli Monitoring, especially of resource models. It also describes how to use the user interface. IBM Tioli Monitoring Resource Model Builder User s Guide, Version 1.1.0, SC Describes using the IBM Tioli Monitoring Resource Model Builder to create and customize resource models. Related publications The following documents also proide useful information: Tioli Software Installation Serice User s Guide, SG Tioli Management Framework User s Guide, GC Tioli Enterprise Installation Guide, GC Tioli Management Framework Reference Manual, SC Tioli Software Distribution User s Guide, GC Tioli Software Distribution Reference Manual, GC IBM Tioli Configuration Manager User s Guide for Inentory, SC IBM Tioli Enterprise Console Eent Integration Facility User s Guide, GC IBM Tioli Enterprise Console Reference Manual, GC IBM Tioli Enterprise Console Rule Builder s Guide, GC IBM WebSphere MQ product documentation IBM WebSphere MQ Integrator product documentation IBM WebSphere MQ Workflow product documentation IBM WebSphere InterChange Serer product documentation IBM Tioli NetView for z/os product documentation IBM IBM Tioli Business Systems Manager product documentation MQSeries Link for R/3 User s Guide, GC TSO/E REXX Reference, SA Tioli Enterprise Data Warehouse product documentation xiii IBM Tioli Monitoring for Business Integration: User s Guide

21 IBM Tioli Monitoring product documentation Road Map for the Typical Installation Option of IBM Tioli Monitoring Products, GI Road Map for Enabling Tioli Enterprise Data Warehouse for IBM Tioli Monitoring Products, SC The Tioli Software Glossary includes definitions for many of the technical terms related to Tioli software. The Tioli Software Glossary is aailable, in English only, at the following Web site: Accessing publications online The documentation CD contains the publications that are in the product library. The format of the publications is PDF, HTML, or both. Refer to the readme file on the CD for instructions on how to access the documentation. IBM posts publications for this and all other Tioli products, as they become aailable and wheneer they are updated, to the Tioli software information center Web site. Access the Tioli software information center by first going to the Tioli software library at the following Web address: Scroll down and click the Product manuals link. In the Tioli Technical Product Documents Alphabetical Listing window, click M to access all of the IBM Tioli Monitoring product manuals. Note: If you print PDF documents on other than letter-sized paper, set the option in the File Print window that allows Adobe Reader to print letter-sized pages on your local paper. The IBM Tioli Software Support Web site proides the latest information about known product limitations and workarounds for your product. You can iew this information at the following Web site: Ordering publications You can order many Tioli publications online at the following Web site: publications/cgibin/pbi.cgi You can also order by telephone by calling one of these numbers: In the United States: In Canada: In other countries, see the following Web site for a list of telephone numbers: About this guide xix

22 Accessibility Contacting software support Accessibility features help users with a physical disability, such as restricted mobility or limited ision, to use software products successfully. With this product, you can use assistie technologies to hear and naigate the interface. You can also use the keyboard instead of the mouse to operate most features of the graphical user interface. For additional information, see the Accessibility Appendix in the user guide for this product. If you hae a problem with any Tioli product, refer to the following IBM Tioli Software Support Web site: If you want to contact software support, see the IBM Software Support Guide at the following Web site: The guide proides information about how to contact IBM Software Support, depending on the seerity of your problem, and the following information: Registration and eligibility Conentions used in this guide Telephone numbers, depending on the country in which you are located Information you must hae before contacting IBM Software Support This guide uses seeral conentions for special terms and actions, and operating system-dependent commands and paths. Typeface conentions This guide uses the following typeface conentions: Bold Italic Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip:, and Operating system considerations:) Keywords and parameters in text Words defined in text Emphasis of words (words as words) New terms in text (except in a definition list) Variables and alues you must proide Monospace Examples and code examples xx IBM Tioli Monitoring for Business Integration: User s Guide

23 File names, programming keywords, and other elements that are difficult to distinguish from surrounding text Message text and prompts addressed to the user Text that the user must type Values for arguments or command options Operating system-dependent ariables and paths The publications in this library use the UNIX conention for specifying enironment ariables and for directory notation. When using the Windows command line, replace $ariable with %ariable% for enironment ariables and replace each forward slash (/) with a backslash (\) in directory paths. The names of enironment ariables are not always the same in Windows and UNIX. For example, %TEMP% in Windows is equialent to $tmp in UNIX. Note: If you are using the bash shell on a Windows system, you can use the UNIX conentions. Tioli command syntax The following special characters define Tioli command syntax: [ ] Identifies elements that are optional. Required elements do not hae brackets around them.... Indicates that you can specify multiple alues for the preious element. Separate multiple alues by a space, unless otherwise directed by command information. If the ellipsis for an element follows a closing bracket, use the syntax within the brackets to specify multiple alues. For example, to specify two administrators for the option [ a admin]..., use a admin1 a admin2. If the ellipsis for an element is within the brackets, use the syntax of the last element to specify multiple alues. For example, to specify two hosts for the option [ h host...], use h host1 host2. Indicates mutually exclusie information. You can use the element on either the left or right of the ertical bar. { } Delimits a set of mutually exclusie elements when a command requires one of them. Brackets ([ ]) are around elements that are optional. In addition to the special characters, Tioli command syntax uses the typeface conentions described in Typeface conentions on page xx. The following examples illustrate the typeface conentions used in Tioli command syntax: wcrtpr [ a admin]... [ s region] [ m resource]... name The name argument is the only required element for the wcrtpr command. The brackets around the options indicate they are optional. The ellipsis after the a admin resource option means that you can specify multiple administrators multiple times. The ellipsis after the m resource option means that you can specify multiple resources multiple times. wchkdb [ o outfile] [ u] [ x] { f infile i object...} The f, i, and object elements are mutually exclusie. Braces that surround elements indicate that you are including a required element. If you specify the object argument, you can specify more than one object. About this guide xxi

24 xxii IBM Tioli Monitoring for Business Integration: User s Guide

25 Part 1. Standard monitoring procedures for all IBM Tioli Monitoring for Business Integration software Copyright IBM Corp

26 2 IBM Tioli Monitoring for Business Integration: User s Guide

27 Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration This chapter proides the following information about monitoring and managing resources on distributed and proxy mode z/os systems: Tioli monitoring enironment oeriew Oeriew of the following software that is collectiely referred to as the IBM Tioli Monitoring for Business Integration product: IBM Tioli Monitoring for Business Integration: WebSphere MQ, including IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow and IBM Tioli Monitoring for Business Integration: WebSphere MQ Message Manager IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Tools for managing IBM Tioli Monitoring for Business Integration resources Administrators Authorization roles Managed resources and endpoints User interface options Tioli monitoring enironment A basic monitoring solution begins with a set of core monitoring products. You can extend the basic monitoring solution with additional products to take full adantage of the collected performance and aailability data. The following products constitute a full monitoring solution: Core monitoring products Tioli Management Framework IBM Tioli Monitoring Additional products to extend monitoring capabilities and collected data IBM Tioli Enterprise Console IBM Tioli Monitoring Web Health Console Tioli Enterprise Data Warehouse IBM Tioli Monitoring Resource Model Builder IBM Tioli Business Systems Manager The additional products use components that are installed on the Tioli serer and gateways to link with IBM Tioli Monitoring on the endpoint. The IBM Tioli Monitoring and Web Health Console components are automatically enabled on the endpoints at the first profile distribution. Products for use with IBM Tioli Monitoring for Business Integration: WebSphere MQ You can extend the monitoring solutions for IBM Tioli Monitoring for Business Integration: WebSphere MQ by adding the following products: IBM Tioli Inentory for the WebSphere MQ component Copyright IBM Corp

28 Tioli Software Distribution for the WebSphere MQ component Tioli management region A Tioli region contains three tiers of resources: the Tioli serer, managed nodes and gateways, and endpoints. In a Tioli enironment, a managed resource is a database object that represents a system or network resource and is goerned by policies. A resource is a hardware, software, or data entity that is managed by Tioli software. Anything that affects the operation of a computer system is a resource, for example, physical and logical disks, CPUs, memory, printers, processes that are running, and serice such as LanMan, Windows eent log, UNIX syslogd (logging system daemon), and TCP/IP. Tioli management region serer Tioli Management Framework software proides the base component for Tioli products. The computer in which this software is installed becomes the Tioli management region serer. The Tioli serer includes the libraries, binaries, data files, and the graphical user interface (GUI) (the Tioli desktop) that are required to install and manage your Tioli enironment. See 1- Tioli Management Framework on page 6 for more information. Managed nodes A managed node runs the same software that runs on a Tioli serer. Managed nodes maintain their own object databases that can be accessed by the Tioli serer. When managed nodes communicate directly with other managed nodes, they perform the same communication or security operations that the Tioli serer performs. 4 IBM Tioli Monitoring for Business Integration: User s Guide

29 The difference between a Tioli serer and a managed node is that the Tioli serer object database is global to the entire region including all managed nodes. In contrast, the managed node database is local to the particular managed node. To manage a computer system that hosts the managed node, install an endpoint on that managed node. Gateways A gateway controls communication and operations with endpoints. Each gateway can support thousands of endpoints. A gateway can launch methods on an endpoint or run methods on behalf of the endpoint. Endpoints A gateway is generally created on an existing managed node. This managed node proides access to the endpoint methods and proides the communication with the Tioli serer that the endpoints occasionally require. Endpoints communicate with the Tioli management region through assigned gateways. An endpoint can be created on UNIX or PC operating systems, including Windows NetWare and OS/2. An endpoint runs the IBM Tioli Monitoring engine. See 7- Endpoints on page 13 for more information about endpoints. Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 5

30 Components of a Tioli monitoring enironment A Tioli monitoring enironment consists of the following components: 1. Tioli Management Framework 2. IBM Tioli Enterprise Console 3. RIM database 4. IBM Tioli Monitoring 5. IBM Tioli Monitoring Web Health Console 6. Profile (resource models) 7. Endpoints 8. Tioli Enterprise Data Warehouse 9. IBM Tioli Monitoring Resource Model Builder 10. IBM Tioli Business Systems Manager The following sections proide descriptions of the components in the Tioli monitoring enironment. 1- Tioli Management Framework Tioli Management Framework is the base component for Tioli products. Using Tioli Management Framework and a combination of Tioli software, you can manage large distributed networks with multiple operating systems, arious network serices, dierse system operations, and constantly changing nodes and users. The Tioli Management Framework function in your IBM Tioli Monitoring software is installed in your Tioli management region or on your Tioli management region serer. When installed, you hae the following tools for managing your resources: 6 IBM Tioli Monitoring for Business Integration: User s Guide

31 Policy regions The policy region is the entry point into the management functions for your software installations. It is installed on your administrator desktop. Task libraries Each IBM Tioli Monitoring software contains two or more task libraries. The name of each task library indicates the type of tasks that the task library contains. For example, configuration task libraries contain tasks that support the discoery and Tioli configuration functions. Operations task libraries contains tasks that support the daily operations for managing resources. Profile managers A profile manager contains resource model profiles for monitoring your resources. Profiles A profile contains the resource models for monitoring your resources. See also 10 and 6- Profile (resource models) on page 12. Resource models The resource models proide best practices monitoring functions for your resources. IBM Tioli Enterprise Console eent classes and rules The eent classes and rules proide a set of eent definitions for iewing changes on your IBM Tioli Enterprise Console console, and proide a set of rules that aggregate and consolidate eents to minimize IBM Tioli Enterprise Console eent traffic. Icons for resources Icons represent arious resources in your software. The icons graphically show the current state of a resource. Context menus from which you can easily access the functions required to manage a resource are aailable using the following icons: Software icon on your administrator desktop Resource icons, one icon for each resource or object being managed Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 7

32 2- IBM Tioli Enterprise Console IBM Tioli Enterprise Console is a rules-based eent management application that collects, processes, and automatically responds to eents. You can install IBM Tioli Enterprise Console on the serer or any managed node or gateway within the Tioli management region. When you install an endpoint, you can enable the sending of eents generated by IBM Tioli Monitoring applications to the IBM Tioli Enterprise Console. You can the enable sending of eents either through a Tioli enironment, which enables you to take adantage of multiple IBM Tioli Enterprise Console serers, or directly to a specific IBM Tioli Enterprise Console serer. IBM Tioli Enterprise Console eent classes and rules proide a set of eent definitions for iewing changes on your IBM Tioli Enterprise Console console, and proide a set of rules that aggregate and consolidate eents to minimize IBM Tioli Enterprise Console eent traffic. 8 IBM Tioli Monitoring for Business Integration: User s Guide

33 3- RIM database You can configure an endpoint to send eents generated by IBM Tioli Monitoring applications to IBM Tioli Enterprise Console. Eents sent from the endpoints are stored in a RIM database. An RDBMS Interface Module (RIM) database is used to store data from resource monitoring. You can hae multiple RIMs in your enironment. Various applications use the data stored in RIMs to produce reports about your monitored enironment. You create a RIM database with an RDBMS serer installation. The RIM database can be part of the Tioli Management Framework or not. System configurations do not require the RDBMS to reside on the same system as the Tioli management region serer or managed node. The RDBMS client on those systems must connect to the remote RDBMS. Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 9

34 4- IBM Tioli Monitoring IBM Tioli Monitoring is an application that applies preconfigured best practices to the automated monitoring of essential system resources. The application detects bottlenecks and other potential problems and proides for automatic recoery from critical situations. IBM Tioli Monitoring performs the following tasks: Monitors operating system status Sends notification of system or performance problems and takes automated, correctie actions Collects and stores system data A Common Information Model (CIM) interface proides all data to the IBM Tioli Monitoring engine. In a Windows enironment, Windows Management Instrumentation (WMI an implementation of CIM by Microsoft) proides the data. In a UNIX enironment, Touchpoint (an implementation of CIM by IBM Tioli) proides the data. IBM Tioli Monitoring is installed on the Tioli management region serer. This application proides three important monitoring elements: Profile The profile is a collected set of information corresponding to a Tioli application resource. For example, the profile contains resource models that define monitoring configurations that monitor specific criteria in your enironment. See also 6- Profile (resource models) on page 12. Heartbeat A heartbeat function regularly monitors endpoints to erify that they are 10 IBM Tioli Monitoring for Business Integration: User s Guide

35 aailable and running correctly. This function proides notification if the engine on an endpoint fails. The heartbeat function is enabled on the gateway of the monitored endpoints. The heartbeat monitoring function sends eents to IBM Tioli Enterprise Console and IBM Tioli Business Systems Manager (proided that the IBM Tioli Business Systems Manager Adapter component is installed at the gateway) and sends notices to the IBM Tioli Monitoring notice group. Data collector The data collector is a component that uploads data from the endpoints to the RIM database for data collection. This RIM database can be the same database that is used for IBM Tioli Enterprise Console or a separate database. 5- IBM Tioli Monitoring Web Health Console IBM Tioli Monitoring Web Health Console, a part of IBM Tioli Monitoring, is a Web-based graphical interface that runs on any system that can be connected through a TCP/IP interface to the Tioli management region. The IBM Tioli Monitoring Web Health Console enables you to iew the health of resources on an endpoint and iew real-time or historical monitored data. A numeric alue between 100 (perfect health) and zero (corresponding eent conditions met) represents the health of each resource. You can access and use the IBM Tioli Monitoring Web Health Console from any Netscape 6.2 (or later) and Internet Explorer 6.x browser on any machine. You can connect the IBM Tioli Monitoring Web Health Console to any Tioli management region serer or managed node and configure it to monitor any or all of the endpoints that are found in that region (assuming that all of the gateways are interconnected). To connect to the IBM Tioli Monitoring Web Health Console you need access to the serer on which the IBM Tioli Monitoring Web Health Console Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 11

36 serer is installed and the IBM Tioli managed region on which you want to monitor health. All user management and security is handled through the IBM Tioli management enironment. This includes creating users and passwords as well as assigning authority. 6- Profile (resource models) The profile is a collected set of information corresponding to a Tioli application resource. For example, the profile contains resource models that define monitoring configurations that monitor specific criteria in your enironment. IBM Tioli Monitoring enables you to deploy preconfigured best practices resource models as well as standard and customized resource models to automate the monitoring of essential resources. A resource model accesses specific performance and operational data from the system at runtime. (For example, the Process resource model gathers data about processes running on the system.) The resource models process the data they collect using an algorithm that determines whether or not the system is performing according to expectations. This enables you to detect bottlenecks and other potential problems and define automatic recoery from critical situations affecting your resources. This ability frees system administrators from manually scanning extensie performance and operational data. 12 IBM Tioli Monitoring for Business Integration: User s Guide

37 7- Endpoints An endpoint proides the primary interface for system management. An endpoint is any computer that runs the lcfd serice (or daemon), which is configured using the lcfd command. Typically, an endpoint is installed on a computer system that is not used for daily management operations. Endpoints run a ery small amount of software and do not maintain an object database. The majority of computers in a Tioli enironment should be endpoints. The Tioli desktop is not installed with the endpoint software. If you choose to run a desktop on an endpoint, you must install Tioli Desktop for Windows or telnet to a UNIX managed node. Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 13

38 8- Tioli Enterprise Data Warehouse Tioli Enterprise Data Warehouse proides a data warehouse with which you can iew historical reports and graphs, enabling you to analyze historical patterns and trends of your enironment. The software maintains historical data for resources that the IBM Tioli Monitoring for Business Integration resource models capture. The warehouse enablement pack for each IBM Tioli Monitoring for Business Integration component proides prepackaged reports to analyze this historical data. You can also create reports to meet your specific needs. Tioli Enterprise Data Warehouse is installed on the Tioli management region serer. The Tioli Enterprise Data Warehouse Support Component (required for interaction with IBM Tioli Monitoring) is installed on the Tioli management region serer, and, optionally, on one or more managed nodes. You must install the component on the serer before you install it on the managed nodes. After installing the component on the serer, you can optionally install the component on one or more managed nodes as well. This component collects the monitored data and stores it in a RIM database. 9- IBM Tioli Monitoring Resource Model Builder IBM Tioli Monitoring Resource Model Builder is an application that enables you to deelop, debug, and package resource models for IBM Tioli Monitoring. IBM Tioli Monitoring Resource Model Builder is independent of the Tioli Management Framework enironment. You can install it on a machine that is not within the Tioli Management Framework. IBM Tioli Monitoring Resource Model Builder is a Windows-only tool. Although it does not run on UNIX systems, you can create resource models for UNIX systems. 14 IBM Tioli Monitoring for Business Integration: User s Guide

39 10- IBM Tioli Business Systems Manager IBM Tioli Business Systems Manager proides a graphical interface to determine the health of an information technology (IT) infrastructure. The software enables you to discoer and create a set of topology iews for your resources. Use IBM Tioli Business Systems Manager to examine how indiidual components or resources affect a business function. You can monitor and manage these resources from an IBM Tioli Business Systems Manager console. IBM Tioli Business Systems Manager requires the IBM Tioli Business Systems Manager adapter to be able to receie IBM Tioli Monitoring eents. The adapter must be installed on all gateways in a region. IBM Tioli Business Systems Manager can be installed on a stand-alone computer that can be part of the Tioli management enironment or not. You must install an IBM Tioli Business Systems Manager adapter on all gateways in a region to be able to receie IBM Tioli Monitoring eents. IBM Tioli Inentory for the WebSphere MQ component IBM Tioli Inentory for the WebSphere MQ component enables you to back up a WebSphere MQ configuration to a Tioli Inentory database and restore the configuration to existing queue managers. You can also clone a WebSphere MQ configuration to a new queue manager. For more information, refer to the information on inentory tasks in the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Tioli Software Distribution for the WebSphere MQ component Tioli Software Distribution for the WebSphere MQ component enables you to perform unattended software distribution and installation of the WebSphere MQ product from a centralized location. For more information, see Chapter 11, Installing WebSphere MQ software, on page 181. Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 15

40 IBM Tioli Monitoring for Business Integration: WebSphere MQ You can manage WebSphere MQ resources on distributed and host systems. This section describes the functions you use to manage these resources and proides information about monitoring WebSphere MQ resources on proxy mode z/os systems. Managing WebSphere MQ resources You can use the following functions to manage WebSphere MQ resources with IBM Tioli Monitoring for Business Integration: WebSphere MQ: Configuration management You can define, change, and delete WebSphere MQ queue managers, queues, channels, and other resources. You can also sae and restore WebSphere MQ configurations to and from a Tioli Inentory database and clone saed WebSphere MQ configurations to Tioli endpoints in your network. For information about the tasks for managing WebSphere MQ resources, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Operations task management IBM Tioli Monitoring for Business Integration: WebSphere MQ enables you to perform tasks such as starting and stopping queue managers, channels, and channel initiators. Some tasks can run automatically in response to a persistent error. For more information about operational tasks, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Aailability management Resource models enable you to monitor WebSphere MQ resource conditions such as queue manager status, channel status, and the number of messages in a queue. For more information about the resource models, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Eent management and filtering You can monitor and retriee WebSphere MQ eents from a queue manager eent queue. The WebSphere MQ eent adapter conerts eents from a queue manager eent queue to Tioli Enterprise Console eent format and forwards these eents to the Tioli Enterprise Console serer (eent serer). For more information on eents, see Chapter 6, Integrating with IBM Tioli Enterprise Console, on page 93. You can specify eents that you do not want to forward to the eent serer in the eent adapter configuration file. Filtering eents preents harmless eents from populating the eent serer database and the eent console so administrators can focus on eents of interest. For more information, see Filtering eents on page 113. Automated responses to eents A set of rules correlates eents and proides automated responses to a ariety of eents. For more information about rules, see Eent rules on page 348. Remote administration You can run many functions for queue managers, channels, and queues on machines that are not Tioli endpoints. This means that you can extend your administration of WebSphere MQ resources to your entire network, 16 IBM Tioli Monitoring for Business Integration: User s Guide

41 including platforms such as VSE/ESA. For more information on remote administration, see Enabling remote administration for WebSphere MQ on page 142. To manage WebSphere MQ queue managers on proxy mode z/os systems, IBM Tioli Monitoring for Business Integration: WebSphere MQ uses the IBM Tioli Business Systems Manager task serer for communication between IBM Tioli Monitoring for Business Integration: WebSphere MQ in a distributed enironment and WebSphere MQ on a proxy mode z/os system. For more information, see IBM Tioli Monitoring for Business Integration: WebSphere MQ for proxy mode z/os. MQSeries Link to R/3 management IBM Tioli Monitoring for Business Integration: WebSphere MQ proides tasks to manage the MQSeries Link for R/3. For more information, refer to the information on MQSeries Link for R/3 tasks in the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Dead-letter queue management IBM Tioli Monitoring for Business Integration: WebSphere MQ proides a task that enables you to create and edit dead-letter queue (DLQ) handler rules tables, and it proides tasks to start and stop the DLQ handler. For more information, refer to the information on the dead-letter queue handler tasks in the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. IBM Tioli Monitoring for Business Integration: WebSphere MQ for proxy mode z/os IBM Tioli Monitoring for Business Integration: WebSphere MQ for proxy mode z/os enables you to run tasks and resource models that manage and monitor WebSphere MQ resources on a z/os system. The IBM Tioli Business Systems Manager task serer proides communication between IBM Tioli Monitoring for Business Integration: WebSphere MQ in a distributed enironment and WebSphere MQ on a z/os system. IBM Tioli Monitoring for Business Integration: WebSphere MQ for proxy mode z/os also proides the following eent adapters: WebSphere MQ Eent Adapter for proxy mode z/os systems Reads eents from WebSphere MQ queue managers running on z/os systems and sends IBM Tioli Enterprise Console eents to the eent serer. The WebSphere MQ eent adapter for proxy mode z/os can also generate write-to-operator (WTO) messages for WebSphere MQ eents. Statistics Eent Adapter Reads WebSphere MQ System Management Facilities (SMF) records and sends IBM Tioli Enterprise Console eents to the eent serer. Managing WebSphere MQ resources on a proxy mode z/os system Monitoring for WebSphere MQ for proxy mode z/os enables sending WebSphere MQ requests for information from a proxy system to a z/os system. Figure 1 on page 18 shows this process. Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 17

42 Tioli Business Systems Manager Task Serer Managed Node Task and Resource Model Flow Tioli NetView z/os IBM Tioli Monitoring for WebSphere MQ Endpoint IHSMDSCV IBM Tioli Monitoring for WebSphere MQ IHSMCMDP Task and Resource Model Flow IBM Tioli Monitoring for WebSphere MQ Gateway IBM Tioli Monitoring for WebSphere MQ Eent Serer Eents Flow Eents Flow Statistics Eent Adapter Eent Adapter for z/os Eents Flow SMF WebSphere MQ Queue Manager IBM Tioli Monitoring for WebSphere MQ Tioli Serer z/os System Eent Flows Task and Resource Model Flows Figure 1. IBM Tioli Monitoring for Business Integration: WebSphere MQ for proxy mode z/os task and resource model flow IBM Tioli Monitoring for Business Integration: WebSphere MQ can request processing by a resource model for a remote proxy mode z/os system. Monitoring for WebSphere MQ for proxy mode z/os processes requests from an IBM Tioli Monitoring for Business Integration: WebSphere MQ task or resource model that is sent to the WebSphere MQ queue manager on the z/os system. For example, an IBM Tioli Monitoring for Business Integration: WebSphere MQ task can start or stop a queue manager on a z/os system. The Channel resource model can monitor the status of a channel on a z/os system. The IBM Tioli Business Systems Manager task serer proides a communication conduit to forward commands to IBM Tioli Monitoring for Business Integration: WebSphere MQ for proxy mode z/os and to receie responses after command execution. Command requests to the WebSphere MQ queue manager go from the task serer to Tioli NetView for z/os for processing. Tioli NetView for z/os routes the output back to the task serer, which forwards the response to the requesting IBM Tioli Monitoring for Business Integration: WebSphere MQ task or resource model. Data between the task serer and Tioli NetView for z/os is encrypted. The following functions are supported: Running WebSphere MQ commands Issuing z/os commands Discoering all occurrences of WebSphere MQ queue managers on target proxy mode z/os systems Running the WebSphere MQ eent adapter and the Statistics Eent Adapter on a proxy mode z/os system enables eents to flow from WebSphere MQ actie queue managers on proxy mode z/os systems directly to the eent serer. 18 IBM Tioli Monitoring for Business Integration: User s Guide

43 Managing WebSphere MQ on multiple proxy mode z/os systems Figure 2 illustrates how you can manage WebSphere MQ resources on multiple proxy mode z/os systems. Tioli NetView for z/os SNA NetView DomainName: D1 TCP/IP Host Name: H1 Tioli NetView for z/os Tioli Business Systems Manager Task Serer Managed Node TCP/IP z/os SNA IBM Tioli Monitoring for WebSphere MQ Queue Manager Remote A z/os TCP/IP Tioli NetView for z/os IBM Tioli Monitoring for WebSphere MQ NetView Domain Name: D2 Tioli NetView for z/os IBM Tioli Monitoring for WebSphere MQ Tioli Business Systems Manager Task Serer Managed Node Queue Manager z/os Queue Manager Remote B z/os Figure 2. Managing WebSphere MQ on Multiple proxy mode z/os Systems The communication protocol used between the task serer and a proxy mode z/os system can be either TCP/IP or SNA. If you hae one or more z/os4 systems remotely attached through the focal point Tioli NetView for z/os, the communication protocol used between the focal point z/os system and one or more remote z/os system must be SNA. When discoering the queue managers on a proxy mode z/os system, you can use either the TCP/IP host name or the NetView domain name of the proxy mode z/os system. For more information about discoering the queue managers, see Populating the management domains on page 176. The proxy mode z/os system that contains the focal point Tioli NetView for z/os does not necessarily contain WebSphere MQ resources or Monitoring for WebSphere MQ for proxy mode z/os. IBM Tioli Monitoring for Business Integration: WebSphere MQ Message Manager IBM Tioli Monitoring for Business Integration: Websphere MQ Message Manager console is a Jaa application implemented as a WebSphere MQ client. You use this application to manage messages through the Message Manager console using tasks such as moing, deleting, and saing messages and exporting and importing message data. Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 19

44 IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow The Workflow component monitors the state of WebSphere MQ Workflow component serices, and workflow process instances. The Workflow component also proides tasks for WebSphere MQ Workflow components. Workflow serer components, also referred to as Workflow serices, coordinate and manage WebSphere MQ Workflow systems and clients. Workflow serices also track and administer processes. Integration of WebSphere MQ monitoring and WebSphere MQ Integrator monitoring You can manage WebSphere MQ Integrator resources (broker, User Name Serer, and Configuration Manager) for any queue manager that IBM Tioli Monitoring for Business Integration: WebSphere MQ manages. To use this feature, you must hae IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator (Monitoring for WebSphere MQ Integrator) installed. For more information, refer to the Display WMQI Objects task in the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator WebSphere MQ Integrator enironment WebSphere MQ Integrator proides a way for you to integrate applications (especially legacy applications) by reformatting messages generated by one application that are destined for another application. Rather than recoding the applications so that both applications conform to the same data interface, you can use this product to tailor message traffic so that it meets existing application interfaces. To reformat application messages, you must be able to intercept the application traffic and process it. Messages are intercepted by rerouting messages from WebSphere MQ queues. WebSphere MQ uses two queues. The source application puts messages on one queue. The target application retriees message from the second queue. As the messages moe from the source queue to the target queue, the messages go through a series of processing nodes. Each node is a mini-application that addresses some aspect of the reformatting process. The series of processing nodes is known as a message flow. The message flow can consist of any number of processing nodes. A broker manages the message flow, and a broker can manage many message flows concurrently. To facilitate processing of these message flows, message flows are processed within broker subprocesses called execution groups. The definition of message formats, reformatting rules, and broker configurations is managed from a central facility called the Configuration Manager. You can access the Configuration Manager to make and deploy changes using a Control Center. The User Name Serer proides security within the WebSphere MQ Integrator enironment. A typical WebSphere MQ Integrator enironment includes the following elements: One Configuration Manager 20 IBM Tioli Monitoring for Business Integration: User s Guide

45 One or more Control Centers Message brokers Optionally, a User Name Serer The brokers and User Name Serer run on Windows and UNIX. The Configuration Manager and the Control Centers run only on Windows platforms. A typical Tioli management enironment consists of a Tioli management region serer (Tioli serer), a Tioli Enterprise Console serer (eent serer), gateways, and Tioli endpoints. To manage the brokers, the Configuration Manager, and the User Name Serer, IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator uses resource models, eent adapters, and tasks. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator represents each WebSphere MQ Integrator component as a Tioli object. Each object is a special type of Tioli endpoint that enables IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator to distribute resource models and tasks directly to the endpoint. You can run a task against one or more WebSphere MQ Integrator components that IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator manages. Managing WebSphere MQ Integrator resources IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides the following functions for monitoring WebSphere MQ Integrator installations: Aailability management IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides resource models that periodically check the status of your WebSphere MQ Integrator components. WebSphere MQ Integrator components can be fully up, partially up, down, or unknown. The resource models automatically update Tioli desktop icons with the current component state. To ensure that you are managing all aailable resources, IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides a Discoer task that finds existing brokers, Configuration Managers, and User Name Serers. As the Discoer task finds new WebSphere MQ Integrator components, the components are automatically added to your Tioli configuration. WebSphere MQ Integrator components report operational changes in their local logs. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides log file adapter functions to extract and report WebSphere MQ Integrator eents from these logs and report them to Tioli. You can iew these eents on the eent console. Note: This function is not aailable for proxy mode z/os systems. You can also forward eents from IBM Tioli Enterprise Console to IBM Tioli Business Systems Manager. Configuration management IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides tasks that help you perform the following operations: Discoer existing WebSphere MQ Integrator components Create WebSphere MQ Integrator components Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 21

46 Change WebSphere MQ Integrator component configurations Delete WebSphere MQ Integrator components The IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator configuration tasks allow you to organize the Tioli serer so that it reflects the structure of your broker domain configuration. Brokers manage the processing resources of execution groups and message flows. When configuration changes are made to these processing resources, WebSphere MQ Integrator reports the changes through a publication facility. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides an eent adapter to receie notifications of these configuration changes and to report them as Tioli eents. You can iew these configuration eents on the eent console, and you can write rules to automatically take action based on these eents. In addition to WebSphere MQ Integrator configuration management, IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides tasks to configure the eent serer and the Tioli log file adapters. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator also proides tasks to install and configure the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator eent adapter and tasks to install the WebSphere MQ Integrator node and the support serices. Performance management IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides a message flow performance resource model and a WebSphere MQ Integrator node which, when properly configured, enable you to report on message flow performance. The node is installed and included in message flows using the Control Center. After the node is included in a message flow, the node collects information that can be reported to Tioli using the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator performance monitors. Using these tools, you can measure message rates through message flows and end-to-end processing time through message flows. Operations management IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides tasks that enable you to manage your WebSphere MQ Integrator components on a daily basis. These tasks start and stop your WebSphere MQ Integrator components and resources, check on the status of your WebSphere MQ Integrator components, retriee information about your WebSphere MQ Integrator component enironment, set WebSphere MQ Integrator tracing options, retriee, and format WebSphere MQ Integrator trace files. WebSphere MQ Integrator components use WebSphere MQ queues and queue managers to perform their processing. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator integrates with the IBM Tioli Monitoring for Business Integration: WebSphere MQ when queue management actions are required. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides eent rules to manage the information presented on your eent console. These rules remoe duplicate eents, remoe harmless eents, and correlate eents to close eents that are no longer releant. You can extend these rules to proide processing unique to your installation. 22 IBM Tioli Monitoring for Business Integration: User s Guide

47 The IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator eent reporting functions support standard Tioli eent filtering. You can use these filtering tools to reduce the number of eents sent to your eent serer. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer WebSphere InterChange Serer enironment WebSphere InterChange Serer is a key component of the IBM WebSphere Business Integration Serer product. IBM WebSphere Business Integration Serer is the IBM business integration solution for process integration, workforce management, and enterprise connectiity. The WebSphere InterChange Serer component addresses the need for efficiency and flexibility in automating and synchronizing business actiities executed across multiple applications as business processes. The WebSphere InterChange Serer maintains the definitions of business processes and data transformations in a central database, hosts and runs the process control functions and data transformation functions, and proides a central control point for managing communication with business applications. The InterChange Serer supports business integration by running collaborations within its own run-time enironment. Collaborations proide the process control needed to synchronize work between applications. The InterChange Serer communicates with business applications using business adapters. The business adapters consist of adapter controllers, running in the InterChange Serer run-time enironment, and adapter agents, running with the business applications. The InterChange Serer proides system management capabilities through an SNMP agent. The SNMP agent monitors and controls the InterChange Serer, its collaborations, and its adapters. Managing and Monitoring WebSphere InterChange Serer IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides the following functions for monitoring WebSphere InterChange Serer installations: Aailability management IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides a resource model that periodically checks the status of your InterChange Serer and the collaborations and adapters used by this InterChange Serer. The InterChange Serer can be up, down, or unknown. The resource model automatically updates the Tioli desktop with the current InterChange Serer status. To ensure that you are managing all aailable InterChange Serers, IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides a discoer task that finds existing InterChange Serers. As the discoer task finds new InterChange Serers, the serers are automatically added to your Tioli configuration. Configuration management IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides tasks that help you perform the following operations: Discoer existing InterChange Serers Discoer existing adapter agents Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 23

48 The IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer configuration tasks allow you to organize the Tioli serer so that it reflects the structure of your InterChange Serer configuration. In addition to WebSphere InterChange Serer configuration management, IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides the following configuration tasks: Configure the eent serer for new eent classes and rules Configure the WebSphere InterChange Serer SNMP agent for use with IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. Operations management IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides tasks that enable you to manage your InterChange Serer and its resources on a daily basis. These tasks start and stop your InterChange Serer and its resources, check on the status of your InterChange Serer and its resources, retriee information about the InterChange Serer resources, and retriee InterChange Serer log and trace files. The InterChange Serer uses WebSphere MQ queues and queue managers to perform processing. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer integrates with IBM Tioli Monitoring for Business Integration: WebSphere MQ when queue management actions are required. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides eent rules to manage the information presented on your eent console. These rules remoe duplicate eents, remoe harmless eents, and correlate eents to close eents that are no longer releant. You can extend these rules to proide processing unique to your installation. Performance management IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides Tioli Enterprise Data Warehouse reports that proide summary information regarding the number of eents processed by each InterChange Serer. Tools for managing IBM Tioli Monitoring for Business Integration resources The Tioli Management Framework function in IBM Tioli Monitoring for Business Integration software proides you with the following tools for managing your resources: Policy regions Monitoring for WebSphere MQ Monitoring for WebSphere MQI Monitoring for WebSphere ICS Task libraries IBM Tioli Monitoring for Business Integration: WebSphere MQ: 24 IBM Tioli Monitoring for Business Integration: User s Guide Each of the IBM Tioli Monitoring for Business Integration: WebSphere MQ task libraries will be prefixed with the name of the management domain in which the task library is located.

49 MQSeries ITM Tasks MQS Utility Tasks Authentication Tasks Channel Tasks Cluster Tasks Cmd Serer Tasks Control Tasks Coupling Facilities Tasks TEC Adapter Tasks Install Tasks MQSeries Inentory Tasks MQSeries Link for R/3 Tasks Name List Tasks Process Tasks Queue Tasks Queue Mgr Tasks MQWF ITM Tasks MVS Control Tasks MVS Security Tasks MVS Storage Class Tasks MVS Trace Tasks IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: MQSI Operational Tasks MQSI Utility Tasks MQSI Eent Tasks IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer: WICS Configuration Tasks WICS Operational Tasks Profile managers IBM Tioli Monitoring for Business Integration: WebSphere MQ: Profiles MQS_domain_name Resource Models MQWF Resource Models IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: WMQI Broker Resource Models WMQI Component Resource Models WMQI PerfDB Resource Models IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer: WICS Serer Resource Models IBM Tioli Monitoring for Business Integration: WebSphere MQ: MQS_domain_name Resource Models Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 25

50 IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: WMQI MessageFlow Status WMQI Component Status WMQI MessageFlow Performance IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer: WICS InterChange Serer Status Resource models IBM Tioli Monitoring for Business Integration: WebSphere MQ: WebSphere MQ Channel WebSphere MQ Error Log WebSphere MQ Queue WebSphere MQ Queue Manager Workflow Component Status Workflow Process Status IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: WebSphere_MQI_Integrator Component Status WebSphere_MQI_Integrator MessageFlowPerformance WebSphere_MQI_Integrator MessageFlowStatus IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer: WICS InterChange Serer Status IBM Tioli Enterprise Console eent classes and rules The eent classes proide a set of eent definitions for iewing changes on your IBM Tioli Enterprise Console. A set of eent rules is also proided to aggregate and consolidate eents to minimize IBM Tioli Enterprise Console eent traffic. Icons See Appendix C, Eent classes and rules, on page 339 for detailed information about the eent classes and rules for the IBM Tioli Monitoring for Business Integration software. IBM Tioli Monitoring for Business Integration: WebSphere MQ: Icon Resource Description IBM Tioli Monitoring for Business Integration: WebSphere MQ software Management domain This is the Monitoring for WebSphere MQ icon on your administrator desktop. It is a policy region, so you can open it to show the resources that it contains. There is one icon for each management domain created. This icon represents an MQS Management domain. 26 IBM Tioli Monitoring for Business Integration: User s Guide

51 Icon Resource Description WebSphere MQ queue manager There is one icon for each queue manager being managed. This icon represents a Tioli WebSphere MQ object. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: Icon Resource Description IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator software Broker Configuration Manager User Name Serer This is the Monitoring for WMQI icon on your administrator desktop. It is a policy region, so you can open it to show the resources that it contains. There is one icon for each broker being managed. This icon represents a Tioli WebSphere MQ Integrator object. There is one icon for each Configuration Manager being managed. This icon represents a Tioli WebSphere MQ Integrator object. There is one icon for each User Name Serer being managed. This icon represents a Tioli WebSphere MQ Integrator object. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer: Icon Resource Description IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer software InterChange Serer This is the product icon on your administrator desktop. It is a policy region, so you can open it to show the resources that it contains. There is one icon for each InterChange Serer being managed. This icon represents a Tioli WICSerer object. This object is also a policy region, so you can open it to show the resources that it contains. Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 27

52 Icon Resource Description SNMP agent Adapter agents There is one icon for each InterChange Serer SNMP agent being managed. This icon represents a Tioli WICSNMP agent object. This icon is in a WICSerer policy region. There is one icon for each adapter agent being managed. This icon represents a Tioli WICSAdapterAgent object. This icon is in a WICSerer policy region. Each WICSerer icon can hae multiple WICSAdapterAgent icons associated with it. Administrators Authorization roles Tioli administrators are system or database administrators who hae the authorization to perform system or database management tasks using the Tioli management enironment. Each administrator or group of administrators is represented by an icon on the Tioli desktop. IBM Tioli Monitoring for Business Integration fully integrates into Tioli security. To perform administration functions, administrators must hae authorization roles for both the IBM Tioli Monitoring for Business Integration component and Tioli Management Framework. The Tioli Management Framework administrator or root administrator can perform tasks and manage policy regions in one or more management regions. The initial administrator who can perform resource management tasks is the Tioli Management Framework administrator or root administrator. After you install IBM Tioli Monitoring for Business Integration, you can define and gie authorization roles to a non-root administrator (it is recommended that you select the administrator for your component). Based on these roles, the IBM Tioli Monitoring for Business Integration administrator can perform assigned tasks. Tioli authorization roles determine the range of actions an administrator can perform in the Tioli Management Framework policy region. You assign roles to administrators so they can perform system or database management procedures. A role can be oer the entire Tioli management region or oer a specific set of resources, such as those contained in a policy region. Examples of standard Tioli Management Framework authorization roles are super, senior, admin, and user. See the Tioli Management Framework User s Guide for information about Tioli Management Framework roles. IBM Tioli Monitoring for Business Integration: WebSphere MQ: MQS_user Start the Queue Manager Control Center, start the Information Centers 28 IBM Tioli Monitoring for Business Integration: User s Guide

53 for the arious WebSphere MQ objects, and display the attributes of WebSphere MQ objects. This authorization role proides read-only authority. MQS_admin Start and stop WebSphere MQ objects and IBM Tioli Monitoring for Business Integration: WebSphere MQ components. This authorization role also includes the authority that the MQS_user and MQS_domain_name_user authorization roles proide. MQS_senior Create, delete, and change WebSphere MQ objects. This authorization role proides the authority to perform all IBM Tioli Monitoring for Business Integration: WebSphere MQ tasks. mqwf_admin Manage the MQ Workflow components. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: mqsi_user Run display tasks. This authorization role proides read-only authority. mqsi_admin Start and stop IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator components. This authorization role also includes the mqsi_user authorization role. mqsi_senior Change configurations, install and uninstall, and add or delete IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator resources. This authorization role proides the authority to perform all IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator roles. This authorization role also includes the mqsi_user and mqsi_admin authorization roles. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator uses Tioli authorization roles to control access to the tasks that enable you to delegate IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator management responsibilities to the appropriate Tioli administrators in your organization. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer: wics_user Perform tasks such as the following that do not change the Tioli system or WebSphere InterChange Serer system: display Tioli logs, display WebSphere InterChange Serer logs, check resource status. wics_admin Perform tasks such as the following that change or modify the Tioli system or WebSphere InterChange Serer system in some way: setting parameters, starting resources, and stopping resources. This role includes the wics_user role. wics_senior Perform security functions and reestablish Tioli endpoints. This role includes the wics_admin and wics_user roles. Chapter 1. Oeriew of IBM Tioli Monitoring for Business Integration 29

54 Managed resources and endpoints IBM Tioli Monitoring for Business Integration: WebSphere MQ: Channel Queue Queue manager IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: Broker User Name Serer Configuration Manager IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer: InterChange serer SNMP agent User interface options Adapter agent You can use the following user interfaces when working with the IBM Tioli Monitoring for Business Integration components: Tioli desktop, which is the traditional Tioli graphical user interface (GUI) Command line interface (CLI) IBM Tioli Monitoring Web Health Console IBM Tioli Enterprise Console to work with eent management IBM Tioli Business Systems Manager to work with eent management and to run some tasks Tioli Enterprise Data Warehouse to gather and report data about your resources 30 IBM Tioli Monitoring for Business Integration: User s Guide

55 Chapter 2. Setting up IBM Tioli Monitoring for Business Integration This chapter proides a suggested order and the procedures for setting up IBM Tioli Monitoring for each of the IBM Tioli Monitoring for Business Integration components: IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer The procedures described in this chapter are not required for IBM Tioli Monitoring for Business Integration: WebSphere MQ if you distribute the resource models when you populate your management domains with the WebSphere MQ resources you want to manage. For more information, see Populating the management domains on page 176. Table 1 proides an ordered list of goals for setting up IBM Tioli Monitoring and shows where you can find the required procedures. When you become more familiar with IBM Tioli Monitoring, you will discoer additional ways of working with resource models that meet the needs of your enironment. Note: For additional or adanced information on IBM Tioli Monitoring in the Tioli enironment, see the IBM Tioli Monitoring User s Guide. Table 1. Setting up resource models Goal 1. Access the interfaces in the Tioli enironment so you can use the operations and functions of the IBM Tioli Monitoring for Business Integration software. 2. Assign the authorization roles for the IBM Tioli Monitoring for Business Integration software to one or more Tioli administrators. 3. Set up profile managers and profiles to organize your resource models. This makes the distribution of resource models more efficient. You might need to set up multiple profile managers and profiles within the profile managers to meet the needs of your enironment. 4. Subscribe endpoints to the profile manager. This determines which resources receie a profile when the profile is distributed. Profiles contain resource models to run against the endpoints (see Step 3). 5. Populate each profile manager/profile with resource models for the resource that you want to monitor. Include resource models with the default alues or customize the default alues to meet the needs of your enironment. Where to find procedures Accessing the Tioli Management Framework enironment on page 32 Setting authorization roles on page 33 Creating profile managers and profiles on page 37 Subscribing resources to profile managers on page 40 Adding a default resource model to a profile on page 41 Copyright IBM Corp

56 Table 1. Setting up resource models (continued) Goal 6. For each profile in your profile manager, do the following: Specify the subscribers that you want to distribute the monitoring profile to and distribute the profile. Specify the subscribers that you want to distribute the monitoring profile to while using MDist2. Determine if you must rerun any failed distributions. Where to find procedures Distributing profiles on page 43 Distributing Profiles using MDist2 on page 43 Rerunning failed profile distributions on page 46 Accessing the Tioli Management Framework enironment Objectie To access the Tioli Management Framework enironment so that you can use the operations and functions of IBM Tioli Monitoring software. Background information You can access the Tioli Management Framework desktop (Tioli desktop) or the Tioli command line interface in order to use the operations and functions of IBM Tioli Monitoring software. The Tioli desktop is a user interface that proides point-and-click access to IBM Tioli Monitoring for Business Integration features and functions. The Tioli desktop proides a central control point for you to organize, manage, and delegate system management operations. IBM Tioli Monitoring for Business Integration also proides a command line interface (CLI) that enables you to enter commands from the keyboard. You can use these commands in shell scripts and with system utilities such as the UNIX cron utility. For more information about using commands, refer to the Tioli Management Framework Reference Guide. Required authorization role Not applicable. Before you begin Not applicable. When you finish Not applicable. Procedure There are separate logon procedures for UNIX and Windows. For a Windows operating system, use the Windows menu structure. For a UNIX operating system, use the UNIX command line. UNIX: 1. Log on to a UNIX managed node or Tioli management region serer. 2. Run the enironment initialization and setup script. 32 IBM Tioli Monitoring for Business Integration: User s Guide If you are using the Bourne, Korn, or bash shell, run the following command:

57 . /etc/tioli/setup_en.sh If you are using the C shell, run the following command: source /etc/tioli/setup_en.csh 3. Type the tioli command at a command prompt to bring up the Tioli logon screen. See the Tioli Management Framework Reference Guide for more information on this command. Windows NT: Setting authorization roles 1. Log on to a Windows NT managed node or Tioli management region serer. 2. Bring up the Tioli logon screen. Note: If you are using a port other than port 94, configure the shortcut to include -port <port number>. 3. Click Start Programs Tioli Tioli in the Windows task bar to access the login screen of the Tioli desktop. 4. Type the following alues in the fields of the login screen: Host Machine Specifies the Tioli managed node, including the Tioli serer where the Tioli desktop should connect Log In As Specifies the login name to the managed node Password Specifies the password for the specified login name 5. Click OK to open the Tioli desktop. Objectie To enable administrators to run IBM Tioli Monitoring for Business Integration software and tasks by assigning the appropriate authorization roles. Background information IBM Tioli Monitoring for Business Integration software tasks require software-specific authorization roles in addition to the basic Tioli authorization role of admin, senior, or super. The IBM Tioli Monitoring for Business Integration software proides global and domain-specific authorization roles. IBM Tioli Monitoring for Business Integration: WebSphere MQ: For IBM Tioli Monitoring for Business Integration: WebSphere MQ, assigning a global authorization role gies an administrator the same leel of authority in any IBM Tioli Monitoring for Business Integration: WebSphere MQ management domain. Assigning a domain-specific authorization role gies an administrator authority only in the domain to which the authority role corresponds. Domain-specific authorization roles are created each time you create a management domain. Table 2 on page 34 describes the IBM Tioli Monitoring for Business Integration: WebSphere MQ authorization roles, including the role for Workflow. Chapter 2. Setting up IBM Tioli Monitoring for Business Integration 33

58 Table 2. Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere MQ Global authorization role Domain-specific authorization role Proides authority to MQS_user MQS_domain_name_user Start the Queue Manager Control Center, start the Information Centers for the arious WebSphere MQ objects, and display the attributes of WebSphere MQ objects. This authorization role proides read-only authority. MQS_admin MQS_domain_name_admin Start and stop WebSphere MQ resources and IBM Tioli Monitoring for Business Integration: WebSphere MQ components. This authorization role also includes the authority that the MQS_user and MQS_domain_name_user authorization roles proide. MQS_senior MQS_domain_name_senior Create, delete, and change WebSphere MQ resources. This authorization role proides the authority to perform all IBM Tioli Monitoring for Business Integration: WebSphere MQ tasks. mqwf_admin Manage Workflow components. Most IBM Tioli Monitoring for Business Integration: WebSphere MQ tasks require the admin Tioli authorization role. The following tasks require the super Tioli authorization role: Create Management Domain Create Inentory Policy Region Create TBSM Policy Region The following tasks require the senior Tioli authorization role: Set Queue Manager Icon State Create File Pack IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow: The Workflow Serer requires you to connect to the workflow serer with an ADMIN password. You must set the ADMIN password so that the tasks or resource models perform correctly. The Workflow Admin Serice must be set up in order erify the password. If you use one user name/id to create the queue managers for the workflow serers and another user name/id to monitor and manage those queue managers, then the latter user name/id, $tmemqs_user, must be fmc or hae the proper authorizations from IBM Tioli Monitoring for Business Integration: WebSphere MQ. To gie your $tmemqs_user the proper IBM Tioli Monitoring for Business Integration: WebSphere MQ authorizations, use the Setting the ADMIN password on page 206. You might still find that the Workflow Admin Serice cannot run when the queue manager has been started with the $tmemqs_user. In this case, use the Starting the Workflow Admin Serice on page 207 to start the queue manager. This ensures that it is started by the Configuration Administrator user. 34 IBM Tioli Monitoring for Business Integration: User s Guide

59 Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere MQ on page 315 contains a list of the authorization roles required for each IBM Tioli Monitoring for Business Integration: WebSphere MQ task, including Workflow. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: Many of the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator tasks run on the remote machine hosting the WebSphere MQ Integrator componentwebsphere MQ Integrator component. These tasks require a user ID for remote access to WebSphere MQ Integrator resources and the WebSphere MQ resources. These tasks are configured to run as $root_user in Tioli. When necessary, the task switches to the component s serice ID. Table 3 describes the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator roles. Table 3. Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Global authorization role senior admin mqsi_user mqsi_admin mqsi_senior Proides authority to Configure the eent serer and eent console resources Install, uninstall, configure, start, and stop the Tioli log file adapter, and resource models. Run display tasks. This authorization role proides read-only authority. Start and stop IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator components. This authorization role also includes the mqsi_user authorization role. Change configurations, install and uninstall, and add or delete IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator resources. This authorization role proides the authority to perform all IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator roles. This authorization role also includes the mqsi_user and mqsi_admin authorization roles. Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator on page 320 contains a list of the authorization roles required for each IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator task. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer: Table 4 describes the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer authorization roles. Table 4. Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Global authorization role Proides authority to wics_user Perform tasks such as the following that do not change the Tioli system or WebSphere InterChange Serer system: display Tioli logs, display WebSphere InterChange Serer logs, check resource status. Chapter 2. Setting up IBM Tioli Monitoring for Business Integration 35

60 Table 4. Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer (continued) Global authorization role Proides authority to wics_admin wics_senior Perform tasks such as the following that change or modify the Tioli system or WebSphere InterChange Serer system in some way: setting parameters, starting resources, and stopping resources. This role includes the wisc_user role. Perform security functions and reestablish Tioli endpoints. This role includes the wics_admin and wics_user roles. For a list of the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer tasks and the authorization role required for each task, see Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer on page 322. Required authorization roles senior Before you begin Before assigning authorization roles, you must hae installed the IBM Tioli Monitoring for Business Integration software that you plan to use as described in the IBM Tioli Monitoring for Business Integration Installation and Setup Guide. To run IBM Tioli Monitoring for Business Integration: WebSphere MQ tasks from one region on task endpoints in an interconnected region, you must add the authorization roles for the interconnected region in which you run tasks to your current authorization roles. Resources isible in region A do not include resources in region B. Open region B to run tasks on its resources. If you are using IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow, you must hae that software installed. When you finish The administrator must restart the desktop before this change takes effect. Procedure You can perform this procedure from either the Tioli command line or the desktop. Command Line: Use the wsetadmin command to set or change resource authorization roles from the command line. For more information about the wsetadmin command, refer to the Tioli Management Framework Reference Guide. Desktop: 1. Open the Administrators collection to see the icons representing the defined Tioli administrators. 2. Right-click the icon representing the administrator whose role you want to modify to access the pop-up menu. 3. Click Edit Resource Roles to access the Set Resource Roles window. 4. Click a resource for which you want to set the administrator s role from the Resources scrolling list. 5. Add or remoe roles for the selected resources as follows: To add roles for the selected resources, select one or more roles from those shown in the Aailable Roles scrolling list and click the left-arrow. The 36 IBM Tioli Monitoring for Business Integration: User s Guide

61 selected roles are moed from the Aailable Roles scrolling list to the Current Roles scrolling list. You can also double-click an entry in the Aailable Roles scrolling list to moe it automatically to the Current Roles scrolling list. To remoe roles for the selected resources, select one or more roles from those shown in the Current Roles scrolling list and click the right-arrow. The selected roles are moed from the Current Roles scrolling list to the Aailable Roles scrolling list. You can also double-click an entry in the Current Roles scrolling list to moe it automatically to the Aailable Roles scrolling list. Note: The list of roles might include others not mentioned here, depending on the applications that are installed. You must click Change & Close or Change to add and remoe the selected roles. The selected roles are only temporarily moed to the Current Roles or Aailable Roles scrolling lists. 6. If you are adding more than one role, click Change to add or remoe the selected resource roles for the administrator specified. The Set Resource Roles window remains displayed. Note: You must click Change for each resource to which you assign roles. 7. Repeat steps 1 on page 36 through 6 for each resource to which you want to assign roles. 8. Click Change & Close to add or remoe the selected resource roles for the administrator and return to the Administrators window. To add the necessary roles to your current management region roles for an interconnected region, follow these steps: 1. Go to the following directory on the Tioli serer: BINDIR/../generic_unix/TME/MQS/sh 2. Enter the following command: mqs_interregion_roles.sh remote_domain_name where remote_domain_name is the name of the remote WebSphere MQ management domain without the MQS_ prefix Notes: 1. You cannot run the Create Queue Manager or the Discoer Queue Managers tasks in interconnected regions. 2. You can also obtain the mqs_interregion_roles.sh script from the /UTILS directory on the IBM Tioli Monitoring for Business Integration, Version 5.x: Software CD. Creating profile managers and profiles Objectie To create profile managers and profiles so you can organize and distribute your resource models more efficiently. Background information A monitoring profile is a group of defined resource models that you can distribute (download or push) to a subscribed (marked to receie) managed resource in a profile manager. Chapter 2. Setting up IBM Tioli Monitoring for Business Integration 37

62 In addition to actiating default resource models, profile managers and profiles can group resources to enable simultaneous monitoring of multiple resources. You can hierarchically organize the profile managers. The profile manager is the top leel of the organization and contains specific profiles that contain specific resource models. Queue managers are then subscribed to the profile managers, which enable the monitoring information to be channeled to those resources. You can create an unlimited number of profile managers, but it is recommended that they reflect some logical or functional grouping of resources or the business s organizational structure. For example, profile managers could be labeled Sales and Marketing, Administration and Finance, and Operations to reflect a business organization. You can create a dataless profile manager that distributes profiles without regard to the existence of a database on its subscribers. A dataless profile manager distributes to the system files on endpoints and other managed resources that hae a profile database. Howeer, it bypasses the profile database on these systems. Therefore, profiles are aailable only with database profile managers. A profile manager (database or dataless) cannot subscribe to a dataless profile manager. Likewise, dataless profile managers cannot distribute to other profile managers because they require profiles to be written to a profile database. Note: Only non-tioli Management Enironment eents are supported for the OS/400 endpoint adapter. For more information about configuring the WebSphere MQ eent adapters see Configuring the WebSphere MQ eent adapter on page 104. WebSphere MQ profile managers: When you create a management domain for managing your WebSphere MQ resources, IBM Tioli Monitoring for Business Integration: WebSphere MQ automatically creates the MQS_domain_name Resource Models profile manager, which contains the MQS_domain_name Resource Models profile. The MQS_domain_name Resource Models profile contains the following resource models with the default configuration: WebSphere MQ Channel WebSphere MQ Queue WebSphere MQ Queue Manager WebSphere MQ Error Log The profile managers must be dataless profile managers. Note: Only non-tioli Management Enironment eents are supported for the OS/400 endpoint adapter. See Configuring the WebSphere MQ eent adapter on page 104 for more information. WebSphere MQ Integrator profile managers: IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides seeral profile managers. You can use and extend these profile managers and the profiles contained within them. The default profile managers are: WMQI Broker Resource Models The default profile is WMQI MessageFlow Status. The default resource model is WebSphere_MQI_Integrator MessageFlowStatus. WMQI Component Resource Models The default profile is WMQI Component Status. The default resource model is WebSphere_MQI_Integrator Component Status. 38 IBM Tioli Monitoring for Business Integration: User s Guide

63 WMQI PerfDB Resource Models The default profile is WMQI MessageFlow Performance. The default resource model is WebSphere_MQI_Integrator MessageFlowPerformance. WebSphere InterChange Serer profile manager: The WICS Serer Resource Models profile manager contains the resource model profiles that can be distributed to a WebSphere InterChange Serer. Required authorization role admin Before you begin Set up the Tmw2kProfile managed resource types. Refer to the IBM Tioli Monitoring User s Guide for information. When you finish Add resource models to the profile. See Adding a default resource model to a profile on page 41 or Adding a custom resource model to a profile on page 55. Procedure You can perform this procedure from the Tioli command line or from the desktop. Command line: 1. Use the wcrtprfmgr command to create a profile manager. For example, to create a profile manager called ProfMgr2 in the TestRegion policy region, enter the following command: ProfMgr2 2. Optional: Use the wsetpm command to make the profile manager operate in dataless mode. For example, to make the profile manager ProfMgr2 dataless, enter the following command: wsetpm where: -d Specifies that the profile manager operates in a dataless mode. 3. Use the wcrtprf command to create a profile. For example, to create a profile called MarketingProf2 in the ProfMgr2 profile manager, enter the following command: Tmw2kProfile MarketingProf2 For additional information about these commands, see the IBM Tioli Monitoring User s Guide Version Desktop: 1. Open the Policy Region window by following these steps: a. Double-click a policy region icon to open the policy region. b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only: Double-click the appropriate management domain policy region icon to open the policy region. 2. Select Create Profile Manager to open the Create Profile Manager window. 3. Type a unique name in the Name/Icon Label text box. 4. Optional: Select the Dataless Endpoint Mode check box to create the profile manager in dataless mode. 5. Click Create & Close to close the Create Profile Manager window. Chapter 2. Setting up IBM Tioli Monitoring for Business Integration 39

64 6. Double-click the profile manager icon to open the Profile Manager window. 7. Select Create Profile to open the Create Profile window. 8. Type a unique name for the profile in the Name/Icon text box. 9. Select the Tmw2kProfile resource from the Type list. 10. Click Create & Close. An icon for the new profile is displayed in the Profiles area of the Profile Manager window. Subscribing resources to profile managers Objectie To add managed resources to a profile manager so administrators can define which resources to monitor. This task applies to all IBM Tioli Monitoring for Business Integration software. Background information Subscribing resources to a profile manager determines which resources receie a profile when the profile is distributed. IBM Tioli Monitoring uses the list of subscribers to determine which systems are monitored. To add a subscriber to a distributed monitoring profile, you must add the subscriber to the profile manager. Note: Resources can also be subscribed to profiles from the IBM Tioli Monitoring Profile window. See Distributing profiles on page 43. IBM Tioli Monitoring for Business Integration: WebSphere MQ queue managers are automatically subscribed to the MQS_domain_name Resource Models profile manager by default when you run one of the following tasks: Discoer Queue Managers Create Queue Manager Create Queue Manager Icon IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator brokers, Configuration Managers, and User Name Serers are automatically subscribed to the appropriate monitoring profile manager by default when you run one of the following tasks: Discoer Create Broker Create Configuration Manager Create User Name Serer See the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide for the profile names for each task. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer InterChange Serers are automatically subscribed to the WICS Serer Resource Models profile manager by default when you run the Discoer InterChange Serers task or manually create a WICS Serer object. Required authorization role admin Before you begin Create a monitoring profile. See Creating profile managers and profiles on page 37 for information. 40 IBM Tioli Monitoring for Business Integration: User s Guide

65 When you finish Distribute the monitoring profile to the subscribed resources. See Distributing profiles on page 43 for information. Procedure You can perform this procedure from the Tioli command line or from the desktop. Command line: manager. Use the wsub command to add subscribers to the profile For example, to add a queue manager named QM2@diers as a subscriber to the profile manager WMQ_production Resource Models, enter the following command: Resource QMgr:QM2@diers For additional information about this command, refer to the Tioli Management Framework Reference Guide. Desktop: 1. Open the Policy Region window. a. Double-click a policy region icon to open the policy region. b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only: Double-click the appropriate management domain policy region icon to open the policy region. 2. Double-click a profile manager icon to open the Profile Manager window. 3. Select Profile Manager Subscribers to open the Subscribers window. 4. Select the subscribers to receie the profile distribution from the Aailable to become Subscribers scrolling list. 5. Click the left-arrow to moe the selected subscribers to the Current Subscribers scrolling list. 6. Click Set Subscriptions & Close to add the subscribers. Subscribers are displayed in the Subscribers field of the Profile Manager window. Adding a default resource model to a profile Objectie To add a resource model to a profile using its default alues so you can run the resource model immediately. Background information A resource model captures and returns information about a resource or application. You set up resource models and distribute them to the subscribers. Each resource model can monitor multiple resources. Choose the resource models to add to a profile based on the resources you want to monitor. Adding one or more of these resource models to a profile allows you to begin monitoring resources immediately. When you create a management domain to manage your WebSphere MQ resources, IBM Tioli Monitoring for Business Integration: WebSphere MQ automatically adds the following resource models to the MQS_domain_name Resource Models profile within the MQS_domain_name Resource Models profile manager: WebSphere MQ Channel WebSphere MQ Queue Chapter 2. Setting up IBM Tioli Monitoring for Business Integration 41

66 WebSphere MQ Queue Manager WebSphere MQ Error Log Note: You must define channels for the resource model parameters before you distribute them so that the MQ Channel Resource model starts properly. The WebSphere MQ Channel Resource model will start, but will not display data until channels are defined in the parameters section. You can also use customized resource models. For information about customizing the resource models, see Chapter 3, Working with resource models, on page 49. Required authorization role admin Before you begin Create a profile manager and profile. See Creating profile managers and profiles on page 37 for information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 40 for information. For information about each resource model, refer to the reference guide for the IBM Tioli Monitoring for Business Integration component that contains the resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide When you finish Distribute the profile. See Distributing profiles on page 43. Procedure You can perform this procedure from the Tioli command line or from the desktop. Command line: Use the wdmeditprf command to add a customized resource model to a profile. For information about the wdmeditprf command, refer to the IBM Tioli Monitoring User s Guide Version Desktop: 1. Open the IBM Tioli Monitoring Profile window by following these steps: a. Double-click a policy region icon to open the policy region. b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only: Double-click the appropriate management domain policy region icon to open the policy region. c. Double-click the profile manager icon to open the profile manager. d. Double-click the profile icon to which you want to add a customized resource model. 2. Click Add With Defaults to open the Add Resource Models to Profile window. 3. Select the resource model category from the Category drop-down list: WebSphere MQ WebSphere MQ Integrator 42 IBM Tioli Monitoring for Business Integration: User s Guide

67 Distributing profiles WebSphere Interchange Serer 4. Select the resource model you want from the Resource Model drop-down list. 5. Click Add & Close. The resource model is added to the IBM Tioli Monitoring Profile. Objectie To distribute profiles to specified subscribers. Background Information By default, IBM Tioli Monitoring for Business Integration: WebSphere MQ automatically distributes the MQS_domain_name Resource Models profile to the discoered or created queue managers when you run one of the following tasks: Discoer Queue Managers Create Queue Manager Create Queue Manager Icon IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator distributes the WebSphere MQ Integrator Component Status profile when you run one of the following tasks: Discoer Create Broker Create Configuration Manager Create User Name Serer See the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide for the profile names for each task. You can distribute profiles to the following groups: Next leel of subscribers Distributes the profile only to the subscribers named in the Distribute to These Subscribers: scrolling list of the Distribute Profile window. This option does not distribute to subscribers at lower leels of the hierarchy. Perform the distribution process from profile managers at more than one leel to reach all the profile endpoints if a profile manager with subscribers resides at the next lower leel. All leels of subscribers Distributes the profile to all subscribers in the hierarchy. Consider the following example. You hae a profile in which a dataless profile manager is subscribed to a profile manager, and the dataless profile manager has a subscribed endpoint. If you distribute to the next leel of subscribers, the profile manager distributes the profile only to the dataless profile manager. If you distribute to all leels of subscribers, the profile manager distributes the profile to the dataless profile manager and to the endpoint. Select this option if you want to distribute a profile in which your resource is the only subscriber. Distributing Profiles using MDist2: IBM Tioli Monitoring uses Multiplexed Distribution (MDist2) to perform asynchronous profile data transfers through a hierarchy of repeaters. MDist2 returns a sequence of responses containing the distribution status from each endpoint to the application initiating the distribution. Chapter 2. Setting up IBM Tioli Monitoring for Business Integration 43

68 These responses are sent back to IBM Tioli Monitoring in a log file, on the MDist2 command line, or through the MDist2 GUI. IBM Tioli Monitoring uses the following MDist2 functions: Asynchronous deliery IBM Tioli Monitoring submits a distribution request and immediately receies a distribution identifier and confirmation that the distribution is in progress. MDist2 uses the callback function to send the final distribution status for each endpoint when it completes each endpoint distribution instead of waiting until all endpoints are distributed. Assured deliery Ensures that distributed profiles are deliered to the endpoints when there are network interruptions, computer shutdowns, or disconnected endpoints. Assured deliery tries to reestablish the connections until it is either successful or the distribution time expires. The distribution begins at the point where it was interrupted. Check-point and restart Ensures that an interrupted data stream resumes from the last successful checkpoint. You do not hae to resend all the IBM Tioli Monitoring Profile data when the distribution resumes, but only the data that was not sent when the interruption occurred. Data depoting Stores segments of the profile distribution at a depot close to the endpoint so the endpoints can retriee the data from the depot instead of from the source host. This reduces network traffic and speeds up the distribution. Required authorization role admin Before you begin Create a profile manager and profile. See Creating profile managers and profiles on page 37 for information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 40 for information. Add a resource model to a profile. See Adding a default resource model to a profile on page 41 and Adding a custom resource model to a profile on page 55 for information. For information about each resource model, refer to the reference guide for the IBM Tioli Monitoring for Business Integration component that contains the resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide When you finish Not applicable. Procedure You can perform this procedure from the Tioli command line or from the desktop. 44 IBM Tioli Monitoring for Business Integration: User s Guide

69 Command line: Use the wdmdistrib command to distribute the profile to the subscribers of the profile manager. For example, to distribute the default profile WMQ_domain_name Resource Models to a queue manager object labeled QM2@diers, enter the following command: wdmdistrib -p "MQ_domain_name Resource Models"@MqM_QMgr:QM2@diers This command updates subscriber databases and configuration files. If no subscriber is specified, wdmdistrib updates all subscribers. The syntax aries depending on the ersion of Tioli management region that you installed. For more information about the wdmdistrib command, refer to the IBM Tioli Monitoring User s Guide. Desktop: 1. Open the IBM Tioli Monitoring Profile window by following these steps: a. Double-click the policy region icon to open the policy region. b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only: Double-click the appropriate management domain policy region icon to open the policy region. c. Double-click the profile manager icon you want to open the Profile Manager window. d. Double-click the profile you want to distribute to open the IBM Tioli Monitoring Profile window. 2. Click Profile Distribute. The Distribute Profile window opens. 3. Select one of the Distribute To options based on the following descriptions: Next leel of subscribers Distributes the profile only to the subscribers named in the Distribute to These Subscribers: scrolling list of the Distribute Profile window. This selection does not distribute to subscribers at lower leels of the hierarchy. Perform the distribution process from profile managers at more than one leel to reach all the profile endpoints if a profile manager with subscribers resides at the next lower leel. All leels of subscribers Distributes the profile to all subscribers in the hierarchy. Consider the following example. You hae a profile in which a dataless profile manager is subscribed to a profile manager, and the dataless profile manager has a subscribed endpoint. If you distribute to the next leel of subscribers, the profile manager distributes the profile only to the dataless profile manager. If you distribute to all leels of subscribers, the profile manager distributes the profile to the dataless profile manager and to the endpoint. Select this option if you want to distribute a profile in which your resource is the only subscriber. 4. Select Make each subscriber s profile an EXACT COPY of this profile from the Distribution Will options. Additional Information: This option oerwrites the subscriber s profile with an exact copy of the profile that you are distributing. Note: Always select the Make each subscriber s profile an EXACT COPY of this profile option when you distribute a profile to a subscriber. Do not select the Presere modifications in subscriber s copies of the profile option. 5. Select the subscribers to receie the profile using the following steps: Chapter 2. Setting up IBM Tioli Monitoring for Business Integration 45

70 a. Select the list of subscribers that you want to distribute the profile to from the Do Not Distribute to These Subscribers scrolling list. b. Click the left arrow to moe the subscribers to the Distribute to These Subscribers scrolling list. Note: Make sure that each subscriber in the Distribute to These Subscribers scrolling list is the correct type for this resource model profile. IBM Tioli Monitoring for Business Integrator does not support other types of endpoints. 6. Click one of the following: Distribute & Close Distributes the profile immediately, closes the Distribute Profile window, saes the settings you made, and returns to the IBM Tioli Monitoring Profile window. Distribute Distributes the profile immediately, saes the settings you made, and keeps the Distribute Profile window open. Schedule Schedules the distribution of the profile with the Tioli Scheduler. For details about using the Tioli Scheduler, refer to the Tioli Management Framework User s Guide. Rerunning failed profile distributions Objectie To erify that the distribution to an endpoint failed so that you can rerun the distribution for the failed endpoint. Background information When a distribution fails, IBM Tioli Monitoring creates a profile manager that contains the endpoint subscribers that failed. When you successfully redistribute profiles, the software deletes the profile manager that it created for the failed distribution. A wholly or partially unsuccessful redistribution retains the profile manager containing only the subscribers that were unsuccessful in the redistribution. Continue the process of correcting the errors and retrying the distribution until the profile is successfully distributed to all endpoints. Required authorization role admin Before you begin Not applicable. When you finish Not applicable. Procedure You can perform this procedure from the Tioli desktop only. Desktop: 1. Open the IBM Tioli Monitoring Profile window by following these steps: a. Double-click a policy region icon to open the policy region. 46 IBM Tioli Monitoring for Business Integration: User s Guide

71 b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only: Double-click the appropriate management domain policy region icon to open the policy region. 2. Select View Refresh from the Policy Region window to see the new profile managers. 3. Reiew the new profile manager names to determine and correct the cause of the failure. The following profile manager names are deried from a failed distribution: The failed distribution creates the following profile manager name due to a Bad_Interpreter error: OriginalProfileName_Push_Failed_Bad_Interpreter where: OriginalProfileName The name of the profile that you were distributing when the error occurred. The AMW089E error message is displayed at this point, indicating that the resource model type is not compatible with the endpoint operating system. For example, you might hae distributed a Windows resource model to a UNIX-T endpoint. The failed distribution creates the following profile manager name due to any other error: OriginalProfileName_Distribution_Failed where: OriginalProfileName The name of the profile that you were distributing when the error occurred. 4. Subscribe the profile managers that contain the failed endpoints to the profile manager that contained the original profile. Note: This can be done only if the profile manager used for the original distribution was not a dataless endpoint. 5. Distribute the original profile to the failed endpoints by selecting these profile managers as the target for the distribution. You can also edit the profile managers to delete an endpoint from a group of failed endpoints before retrying the distribution. Chapter 2. Setting up IBM Tioli Monitoring for Business Integration 47

72 48 IBM Tioli Monitoring for Business Integration: User s Guide

73 Chapter 3. Working with resource models This chapter describes how to customize a resource model and add it to a profile. Table 5 shows the goals for customizing resource models and where to find the procedures. Table 5. Working with resource models Goal Where to find procedures 1. Add a customized resource model to a profile. Adding a custom resource model to a profile on page Customize indication rules so that resources are monitored and eents generated in the manner most appropriate to your enironment. 3. Specify a task so you can determine correctie or reporting tasks for an eent. 4. Send a notice in response to an eent so you can take the appropriate actions or responses. 5. Customize the parameters of a resource model so you can optimize the monitoring process. 6. Customize the scheduling for a resource model so you can determine the time periods and days when monitoring takes place. 7. Customize data logging information so you can log data collected by a resource model and write it in a local database. 8. Manage profiles and resource models after they are distributed to endpoints so you can maintain monitoring processes on those endpoints. 9. Manage IBM Tioli Monitoring on gateways so you can run monitoring processes on those gateways. 10. Determine which resource models are running on an endpoint. Customizing indications and eents on page 57 Specifying tasks for an indication on page 60 Sending a notice to administrators when an eent occurs on page 62 Customizing parameters on page 63 Customizing a schedule for a resource model on page 64 Customizing data logging information on page 67 Managing profiles and resource models at endpoints on page 69 Managing IBM Tioli monitoring on gateways on page 70 Determining which resource models are running on endpoints on page 72 Resource model concepts Resource models are the key concept for understanding the IBM Tioli Monitoring product. The other concepts described here are related to how resource models monitor resources and which parts of resource models you can customize to monitor your resources. For additional information about resource models, see the IBM Tioli Monitoring Resource Model Builder User s Guide and the IBM Tioli Monitoring User s Guide. Resource models With IBM Tioli Monitoring component software you can deploy preconfigured best practices resource models as well as customized Copyright IBM Corp

74 resource models to monitor essential resources. A resource model accesses specific performance data from the system at runtime. (For example, the Process resource model gathers data about processes running on the system.) The resource models process the data they collect using an algorithm that determines whether or not the system is performing to expectations. This enables you to detect bottlenecks and other potential problems and define automatic recoery actions from critical situations affecting your resources. This ability frees system administrators from manually scanning extensie performance data. The monitoring software integrates with other Tioli Aailability solutions, including IBM Tioli Business System Manager, IBM Tioli Enterprise Console, IBM Tioli Monitoring Web Health Console, and Tioli Enterprise Data Warehouse. A resource model captures and returns information, such as database status or serer aailability, about a resource or software application in the Tioli management enironment. To use a resource model, you must define it and distribute it to an endpoint. You can either use the default alues for a resource model to collect performance data or customize a resource model to match specific requirements in your enironment. Distributing resource models using default alues enables you begin monitoring immediately to obtain useful data concerning your enterprise. As you become more familiar with the monitoring process and feedback, you might choose to customize the resource model information. You use IBM Tioli Monitoring Resource Model Builder to deelop new resource models. See the IBM Tioli Monitoring Resource Model Builder User s Guide for information about how to deelop a new resource model. You can use the IBM Tioli Monitoring software to customize existing resource models. When you customize a resource model, you can modify the following elements of the resource model configuration: Cycle time Thresholds Indications Occurrences Holes Sending eents to IBM Tioli Enterprise Console Sending eents to IBM Tioli Business Systems Manager (Not all IBM Tioli Monitoring software supports this option.) Seerity of eent Recoery actions and tasks Parameters Schedule Logging See the Reference Guide for the IBM Tioli Monitoring for Business Integration software that you are using for a description of the indiidual settings for each preconfigured resource model. Attributes A resource model has attributes that it receies when it is deeloped in IBM Tioli Monitoring Resource Model Builder. You do not add, delete, or modify attributes when you customize a default resource model. The 50 IBM Tioli Monitoring for Business Integration: User s Guide

75 attributes identify information for the resource model to monitor. Attributes are string or numeric alues. For example, if an indication identifies insufficient disk space, attributes such as disk name or aailable disk space allow the resource model to more precisely identify a problem. For each resource model, some of the attributes are designated as keys. Cycle time When a resource model runs on an endpoint, it gathers data at regular interals, called cycles; the interal between cycles is the cycle time, which is displayed in seconds. A resource model with a cycle time of 60 seconds gathers data eery 60 seconds. Each of the preconfigured resource models has a default cycle time that you can modify when you define the resource model. At each cycle, the resource model collects data, analyzes it, generates the eents, and triggers specified actions. The data collected are a snapshot of the status of the resources specified in the resource model. Thresholds A resource model has one or more thresholds. Each threshold has a default numeric alue that you can change. The monitoring algorithm written in the script determines how the resource model uses a threshold. The following examples describe how a resource model can use thresholds: A threshold alue might represent a limit that, if not met, indicates an unsatisfactory resource state. For example, if you want the system to notify you when disk space drops under 70%, set the threshold alue to 70 to generate an indication each time your disk space is less than 70%. Some threshold alues control the scope of what the resource model monitors. For example, the Windows Process resource model uses the Maximum Processes threshold to limit the number of processes monitored for the highest usage of CPU. Thus, if you set the Maximum Processes threshold to 5, the resource model only reports on the fie highest CPU-using processes. Parameters While thresholds can only be numeric alues, parameters can be numeric or string alues. You can customize the parameters for a resource model to meet your requirements. For each parameter you can specify a numeric or string alue to represent the instances you want to monitor or a limit you do not want your resource to exceed. When you deelop a resource model using IBM Tioli Monitoring Resource Model Builder you can define default parameters. You can customize the settings for parameters in the IBM Tioli Monitoring software you are using to monitor your resources. Choose one of the following kinds of lists when you specify the parameters: Boolean List Choice List String List Numeric List Some resource models hae no parameters, others hae one or more parameters. For example, the Windows Parametric TCP/IP Ports resource model uses parameters that contain lists of ports and port states that you want to monitor. Indications Each resource model generates an indication in a gien cycle based on the settings defined for it. A single occurrence of an indication does not always Chapter 3. Working with resource models 51

76 represent a problem, howeer the persistence of indications might. The resource model measures the persistence of the indications and aggregates them according to the settings for occurrences and holes. If the persistence of an indication meets the specified number of occurrences, the resource model generates an eent. Indications can be generated in any one of the following conditions: When a single threshold is exceeded. For example, in the Windows Process resource model, the Process High CPU indication is generated when the High CPU Usage threshold is exceeded (for any process that has a non-zero process ID). When a combination of two or more thresholds are exceeded. For example, in the Windows Logical Disk resource model a High Read Bytes per Second indication is generated when both of the following thresholds are exceeded: The amount of bytes transferred per second (being written or read) exceeds the High Bytes per Second threshold. The percentage of time that the selected disk drie spends making read or write requests exceeds the High Percent Usage threshold. When a combination of other factors change. For example, in the Windows Process resource model the Process Handle Leak indication is generated when a process is losing memory. There is no threshold for this indication. The resource model compares the number of handles of the fie processes with the most handles in consecutie cycles. If the number of handles has increased, the indication is generated. You can configure indications by specifying the following information: Occurrences: number of cycles during which at least one threshold is exceeded and an indication occurs Holes: number of cycles during which an indication does not occur Sending eents to IBM Tioli Enterprise Console: whether you want to notify the IBM Tioli Enterprise Console serer when the indication generates an eent Sending eents to IBM Tioli Business Systems Manager (not all IBM Tioli Monitoring software has this option): whether you want to notify IBM Tioli Business Systems Manager when the indication generates an eent Seerity of eent 52 IBM Tioli Monitoring for Business Integration: User s Guide Recoery actions and tasks Occurrences and holes Occurrences and holes record whether or not an indication occurs during the cycle for a specific resource model. An occurrence is a cycle during which at least one threshold is exceeded and an indication occurs for a gien resource model. A hole is a cycle during which an indication does not occur for a gien resource model. A hole means none of the conditions that generate an indication were met, but it does not necessarily mean that no thresholds were exceeded. For example, in the Windows Logical Disk resource model a High Read Bytes per Second indication is not created when the percentage disk time is higher than the High Percent Usage threshold, proided that the Low Disk Space threshold is exceeded.

77 IBM Tioli Enterprise Console serer When the settings for an indication include sending eents to the IBM Tioli Enterprise Console serer, you can iew the eents in the IBM Tioli Enterprise Console if you hae compiled and loaded the releant Basic Recorder of Objects in C (BAROC) files on the serer. The eent contains a set of properties that can help to identify the problem. For example, the information in the ProcessHandleLeak eent includes alues for the following attributes: Current Process ID Number of handles allocated to the process Name of the process Clearing eents can also be processed by the IBM Tioli Enterprise Console serer. If the default procedure is used to enable the monitoring of eents, the IBM Tioli Enterprise Console serer uses the clearing eent to close the associated error eent. IBM Tioli Business Systems Manager Indications can also send eents to the IBM Tioli Business Systems Manager, if the IBM Tioli Business Systems Manager Adapter component is installed on the gateways of the endpoints that are to be monitored. A full description of IBM Tioli Business Systems Manager can be found in the IBM Tioli Business Systems Manager documentation. Clearing eents can also be processed by the IBM Tioli Business Systems Manager, which uses the clearing eent to close the associated error eent. Seerity The degree of seerity an eent must reach for the system to notify the IBM Tioli Enterprise Console serer or IBM Tioli Business Systems Manager that there is a problem. An eent can hae one of the following degrees of seerity: fatal, critical, warning, harmless, or minor. Recoery actions For any indication, recoery actions can run automatically. There are two types of recoery actions: built-in actions (for Windows) and tasks. Both of these types of actions take positie steps to remedy the situation, or ensure that information about the indication is distributed to the appropriate authorities or entities. Built-in actions are associated with an indication by default. You can associate one or more recoery actions with a specific indication. These actions are automatically triggered when the eent occurs and, typically, are used for restoring satisfactory system serice leel. Each time an indication occurs, the system proides notification that the indication occurred, triggers a recoery action to restore satisfactory conditions; and if the action is successful, proides notification that the action was performed. Actions are associated with the execution of a CIM method or the execution of a program. Associate actions with indications when modifying an existing resource model using this software, or when creating a new resource model with the IBM Tioli Monitoring Resource Model Builder. Chapter 3. Working with resource models 53

78 Note: The IBM Tioli Monitoring for Business Integration: WebSphere MQ resource models do not include preconfigured recoery actions. Built-in Actions An indication can hae one or more built-in actions predefined for them. An action can be either the execution of a CIM class method or the execution of a program. Both types of actions can be built into the indication only by using IBM Tioli Monitoring Resource Model Builder. For example, an eent that detects the failure of a serice might restart that serice as its built-in action. Thus, without any human interention, IBM Tioli Monitoring detects the failure of a serice and automatically restarts it. Built-in actions hae the same eent ID as the eent that they are designed to correct. Tasks (recoery) For each eent that a resource model generates, you can select one or more Tioli Management Framework tasks to be performed when the indication that triggered the eent occurs. Eents An eent erifies the persistence of an indication by eliminating unrepresentatie peaks and troughs for the indication. For example, a process that generates the Process High CPU indication in one cycle might not threaten other processes if the high usage is not repeated. Howeer, an indication that persists oer seeral cycles is more likely to be a problem. Thus, an eent defines the significant number of consecutie occurrences of the indication. Clearing eents A clearing eent is a resource model function that is enabled or disabled when the resource model is deeloped. You cannot disable them when you customize a resource model in the monitoring software. If enabled, clearing eents allow IBM Tioli Monitoring software to close an eent when the circumstances that caused the eent are no longer present. Clearing eents can be processed by the IBM Tioli Enterprise Console serer and by IBM Tioli Business Systems Manager. Clearing eents hae a seerity of harmless, regardless of the seerity of the original eent, but hae the same eent ID as the original eent. For example, if a serice stops, the IBM Tioli Enterprise Console serer receies an eent notifying it of this problem. Until the serice restarts, the problem is still present on the endpoint, but IBM Tioli Monitoring does not send any further eent notifications to the IBM Tioli Enterprise Console serer. If the Clearing Eent function is enabled, as soon as the serice restarts, a clearing eent is sent to the IBM Tioli Enterprise Console serer, thereby closing the original eent. The Clearing Eent itself does not normally appear on the serer, because its only function is to clear the original error eent. Note: Correlated eents cannot be cleared. 54 IBM Tioli Monitoring for Business Integration: User s Guide

79 Scheduling IBM Tioli Monitoring contains a scheduling feature that enables you to determine a period within which monitoring takes place and specific scheduling rules. The monitoring period is determined by defining a from and a to date. The scheduling rules enable you to define time periods on specific days of the week during which monitoring takes place. Any number of rules can be defined, allowing you to set up a complex pattern of resource monitoring for a profile, coering the time periods important to you. The scheduled times are always interpreted as local times, enabling you to set up a single rule that monitors the same local time period in different time zones. For example, if your region coers seeral time zones, but you want to monitor morning actiities in each time zone, a single rule defining the monitoring period of between 08:00 and 13:00 is interpreted locally in each of the time zones, so that you monitor the same relatie period. All of the times for eents or actiities reported from endpoints or gateways are also logged in the local time of the system where they originated. Logging Resource models support data logging to collect and store monitoring data in a local database. You can choose to store raw or aggregated data. For raw data, iew results through the History View of the IBM Tioli Monitoring Web Health Console. For aggregated data, use Tioli Enterprise Data Warehouse. Adding a custom resource model to a profile Objectie To add a customized resource model so you can specify the type of platform, the cycle time, the threshold alues, and other settings that meet the needs of your enironment. Background information A resource model captures and returns information about a resource or application. You set up resource models and distribute them to objects that represent the resources you want to monitor. In addition to using the predefined resource models that are installed with the product, you can customize any of the predefined resource models. Each resource model monitors a different resource. Resource models are grouped into categories that represent platforms, for example, Solaris, Unix - Linux, and Windows. You choose resource models from a category to add to a profile and customize it based on the resources you want to monitor and the settings you want to use to monitor those resources. If you want to modify these categories or add other categories, use IBM Tioli Monitoring Resource Model Builder. When you add a custom resource model, you can modify the settings for the following resource model parts: Cycle Time Thresholds Indications Chapter 3. Working with resource models 55

80 Tasks associated with indications Parameters Schedule Logging You might find it useful to put all of the resource monitors that you want to distribute to the same endpoint in a single profile because the distribution occurs at the indiidual profile leel. Required authorization role admin Before you begin 1. Create a profile manager and profile. See Creating profile managers and profiles on page 37 for information. 2. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 40 for information. 3. See the IBM Tioli Monitoring for Business Integration component reference guide for detailed information about each resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide When you finish Distribute the profile. See Distributing profiles on page 43. Procedure You can perform this procedure from the Tioli command line or from the desktop. Command line: Use the wdmeditprf command to add a customized resource model to a profile. For more information about the wdmeditprf command, refer to the IBM Tioli Monitoring Reference Guide. Desktop: 1. Open the IBM Tioli Monitoring Profile window by following these steps: a. Double-click the policy region icon to open the policy region. b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only, double-click the appropriate management domain policy region icon to open the policy region. c. Double-click the profile manager icon to open the Profile Manager window. d. Double-click the profile icon to which you want to add a customized resource model. 2. Click Add from the IBM Tioli Monitoring Profile window to open the Add Resource Models to Profile window. 3. Select the category of the resource model from the Category drop-down list. 4. Select the resource model that you want to customize from the Resource Model drop-down list. Additional information: For information about the resource models, refer to the reference guide for the software you are using. 56 IBM Tioli Monitoring for Business Integration: User s Guide

81 5. Set the frequency (in seconds) with which the resource model monitors the data in the Cycle Time text box. 6. Use the following steps to change any of the threshold alues: a. Select the Threshold Name that you want to change. Additional information: The description box displays a description of the threshold that you selected. A window aboe the description displays the currently assigned threshold alue. b. Change the currently assigned threshold alue to a alue appropriate to your requirements. Additional information: For information about the default alues, refer to the reference guide for the software you are using. c. Click Apply to set and display the new alue in the Threshold Value window. 7. Click one or more of the options along the bottom of the Add Resource Models to Profile window one at a time to change the following settings: Additional information: An option is not actie if you cannot customize the settings for that part of the resource model. If you choose not to customize a setting, the resource model retains the default settings. Indications (occurrences, holes, where to send eents, seerity, tasks) See Customizing indications and eents. See Specifying tasks for an indication on page 60. Parameters See Customizing parameters on page 63 for how to change the parameters for the resource model. Logging See Customizing data logging information on page 67 for how to enable logging and how to aggregate data. Schedule See Customizing a schedule for a resource model on page 64 for how to set the schedule for running a resource model. 8. Click Add & Close to sae your changes. The IBM Tioli Monitoring Profile window now shows the customized resource model. Customizing indications and eents Objectie To modify the occurrences, holes, which tasks to run, where to send eents, and eent seerity aspects of indications so you can customize a resource model to generate an eent that notifies you when a monitored resource is not performing as required. Background information Each resource model generates an indication if certain conditions defined by the resource model thresholds are not satisfied during the monitoring cycle. Each resource model has its own algorithm to determine the combination of settings that generate an indication. An eent erifies the persistence of a gien indication by eliminating unrepresentatie peaks and troughs for the indication. For example, a process that generates the Process High CPU indication in one cycle might not pose a threat to other processes if the high usage is not repeated. Howeer, an indication that Chapter 3. Working with resource models 57

82 persists oer seeral cycles is more likely a problem. Thus, an eent defines the number of consecutie occurrences of the indication. You can customize the following alues for indications and eents: Occurrences Refers to a cycle during which an indication occurs for a gien resource model. Specifies the number of consecutie times the problem occurs before the software generates an indication. You can change this alue to specify the number of times a problem occurs before an indication generates. Holes Refers to a cycle during which an indication does not occur for a gien resource model. In other words, none of the conditions specified for the generation of any indication are met. This does not mean that none of the thresholds are exceeded. Rather you determine how many cycles that do not produce an indication can occur between cycles that do produce an indication. This determines if the occurrences of an indication are consecutie. Each cycle without an indication is termed a hole. For example, an eent that has a alue of two holes means that when up to two cycles occur without an indication between any two cycles with an indication, the cycles with an indication are considered consecutie. Use the alue for the Number of Holes in conjunction with the Number of Occurrences parameter and the Cycle Time to define a time window for the generation of an eent. If, for example, you define Cycle Time as 10 seconds, Number of Occurrences as 5, and Number of Holes as 2, the time that must elapse before an eent occurs is between 50 and 130 seconds. The minimum elapsed time is the number of occurrences multiplied by the cycle time. The maximum time window assumes that the maximum number of holes occurs between each pair of occurrences, and is determined by the following equation: TW=CT x (Oc + (H x (Oc - 1)) where: TW CT Oc H Specifies the time window calculated Specifies the cycle time Specifies the number of occurrences Specifies the number of holes Send TEC Eents Specifies that if an eent occurs, the specified eent serer receies a message from IBM Tioli Enterprise Console if you hae IBM Tioli Enterprise Console installed. Note: For IBM Tioli Monitoring for Business Integration: WebSphere MQ, Tioli Business Systems Manager receies the eent if IBM Tioli Enterprise Console and IBM Tioli Business Systems Manager are both installed. Seerity Indicates how serious an eent is if it is triggered: fatal, critical, warning, harmless, minor. Tasks Specifies which tasks you want to run automatically when the resource model raises the indication with which the task is associated. 58 IBM Tioli Monitoring for Business Integration: User s Guide

83 Required authorization role admin Before you begin 1. Set up profile manager and profiles to organize your resource models. See Creating profile managers and profiles on page Add subscribers to a profile manager. See Subscribing resources to profile managers on page Add a resource model that you can modify to each profile manager and profile. See Adding a custom resource model to a profile on page See the IBM Tioli Monitoring for Business Integration component reference guide for detailed information about each resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide If you want the indication to send an eent to IBM Tioli Business Systems Manager, make sure you hae performed the following procedures: 1. Install the WebSphere MQ integration with IBM Tioli Business Systems Manager as described in Integrating with IBM Tioli Business Systems Manager on page Create the WebSphere MQ integration with IBM Tioli Business Systems Manager task libraries as described in Creating the WebSphere MQ task libraries for IBM Tioli Business Systems Manager on page Discoer the WebSphere MQ resources you want to manage on the Tioli Business Systems Manager console as described in Discoering WebSphere MQ resources for IBM Tioli Business Systems Manager on page 126. When you finish 1. Modify any other resource model settings that you want to change: Tasks. See Specifying tasks for an indication on page 60. Parameters. See Customizing parameters on page 63. Schedules. See Customizing a schedule for a resource model on page 64. Logging. See Customizing data logging information on page Distribute the profile to which the resource model belongs. For more information, see Distributing profiles on page 43. Procedure You can perform this procedure from the Tioli command line or from the desktop. Command line: a profile. Use the wdmeditprf command to customize a resource model for Desktop: 1. Open the IBM Tioli Monitoring Profile window by following these steps: a. Double-click a policy region icon to open the policy region. b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only, double-click the appropriate management domain policy region icon to open the policy region. c. Double-click the profile manager icon to open the profile manager. Chapter 3. Working with resource models 59

84 d. Double-click the profile icon in which you want to customize a resource model. 2. Select the resource model that you want to customize from the IBM Tioli Monitoring Profile window. 3. Click Edit to open the Edit Resource Model window. 4. Click Indications to open the Indications and Actions window and the indications releant to the selected resource model. 5. Select the indication you want to customize. 6. Apply the changes to the alues that are releant for your requirements as described in the background information of this procedure as follows: Send eent to IBM Tioli Enterprise Console Send eent to IBM Tioli Business Systems Manager Occurrences Holes Seerity Execute Tasks Additional information: See the reference guide for the software you are using for the default alues. 7. Click Apply Changes & Close to sae your changes to the indication. Specifying tasks for an indication Objectie To specify a task so you can determine correctie or reporting tasks for an indication. Background information You can select one or more tasks to perform when an indication is raised. These tasks can access the IBM Tioli Monitoring eent name by accessing the enironment ariables. The following IBM Tioli Monitoring for Business Integration components hae libraries of automated tasks that you can associate with resource model indications: IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer For information about each automated task, see the Reference Guide for each component. Required authorization role admin Before you begin 1. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 40 for information. 2. Add a resource model that you can modify to each profile manager and profile. See Adding a custom resource model to a profile on page See the IBM Tioli Monitoring for Business Integration component reference guide for detailed information about each resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide 60 IBM Tioli Monitoring for Business Integration: User s Guide

85 IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide Note: If you are using IBM Tioli Monitoring for Business Integration: WebSphere MQ and you discoered queue managers when you installed the software, you do not need to perform the aboe procedures. When you finish 1. Modify any other resource model settings that you want to change: Indications. See Customizing indications and eents on page 57. Parameters. See Customizing parameters on page 63. Schedules. See Customizing a schedule for a resource model on page 64. Logging. See Customizing data logging information on page Distribute the profile to which the resource model belongs. For more information, see Distributing profiles on page 43. Procedure You can perform this procedure from the Tioli command line or from the desktop. Command line: a profile. Use the wdmeditprf command to customize a resource model for Desktop: 1. Open the IBM Tioli Monitoring Profile window by following these steps: a. Double-click a policy region icon to open the policy region. b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only, double-click the appropriate management domain policy region icon to open the policy region. c. Double-click the <domain name> Resource Models profile manager icon to open the profile manager. d. Double-click the profile icon in which you want to customize a resource model. 2. Select the resource model that you want to customize from the IBM Tioli Monitoring Profile window. 3. Click Edit to open the Edit Resource Model window. 4. Click Indications to open the Indications and Actions window and the indications appropriate to the selected resource model. 5. Select the indication for which you want to run a task from the Indications and Actions window. 6. Click Tasks in the Action List area of the Indications and Actions window to open the Tasks window. 7. Double-click the appropriate task library from the list in the Libraries panel. The tasks contained in the library are displayed in the Tasks panel. 8. Double-click the appropriate task in the Tasks panel. 9. Specify the appropriate parameters in the Configure Task window. Additional information: Run the wlsnotif -g command to see the aailable Notice Groups. 10. Click Change & Close to add the task to the Action List panel in the Indications and Actions window. Chapter 3. Working with resource models 61

86 OR Click Apply Change and Close to sae the updated action information. OR Click Modify and Close to sae the updated resource model. Sending a notice to administrators when an eent occurs Objectie To send a notice in response to an eent so you can take the appropriate actions or responses. Background information To set up tasks that send notices when an eent occurs, you use the procedure, Specifying tasks for an indication on page 60. In this procedure, you specify the IBM Tioli Monitoring Utility Tasks task library and the send notices task. Required authorization role admin Before you begin 1. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 40 for information. 2. Add a resource model that you can modify to each profile manager and profile. See Adding a custom resource model to a profile on page See the IBM Tioli Monitoring for Business Integration component reference guide for detailed information about each resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide When you finish 1. Modify any other resource model settings that you want to change: Indications. See Customizing indications and eents on page 57. Tasks. See Specifying tasks for an indication on page 60. Parameters. See Customizing parameters on page 63. Schedules. See Customizing a schedule for a resource model on page 64. Logging. See Customizing data logging information on page Distribute the profile to which the resource model belongs. For more information, see Distributing profiles on page 43. Procedure You can perform this procedure from the Tioli command line or from the desktop. Command line: a profile. Use the wdmeditprf command to customize a resource model for Desktop: 1. Open the IBM Tioli Monitoring Profile window by following these steps: a. Double-click a policy region icon to open the policy region. 62 IBM Tioli Monitoring for Business Integration: User s Guide

87 Customizing parameters b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only, double-click the appropriate management domain policy region icon to open the policy region. c. Double-click the profile manager icon to open the profile manager. d. Double-click the profile icon in which you want to customize a resource model. 2. Select the resource model that you want to customize. 3. Click Edit to open the Edit Resource Model window. 4. Click Indications to open the Indications and Actions window and the indications appropriate to the selected resource model. 5. Select the indication that you want to generate a task from the Indications and Actions window. 6. Click Tasks in the Action List window next to the Action List to open the Tasks window. 7. Double-click the IBM Tioli Monitoring Utility Tasks task library in the scroll list of the Libraries panel. The tasks in the IBM Tioli Monitoring Utility Tasks task library are displayed in the Tasks panel. 8. Double-click the name of the task in the Tasks panel to open the Configure Task window: IBM Tioli Monitoring for Business Integration: WebSphere MQ: dm_mn_send_notice IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: dm_mn_send_notice IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer: dmae_mn_send_notice 9. Specify the appropriate parameters in the Configure Task window. Additional Information: Run the wlsnotif -g command to see the aailable notice groups. 10. Click Change & Close to add the task to the Action List panel in the Indications and Actions window so the list of tasks runs when the indication occurs. Objectie To customize the parameters of a resource model so you can optimize the monitoring process. Background information Some resource models hae one or more parameters. Each parameter can take the form of a list of strings, a list of numeric alues, a Boolean list of predetermined alues from which you can make any combination of selections, or a choice list of mutually exclusie alternaties. Required authorization role admin Before you begin 1. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 40 for information. 2. Add a resource model that you can modify to each profile manager and profile. See Adding a custom resource model to a profile on page 55. Chapter 3. Working with resource models 63

88 3. See the IBM Tioli Monitoring for Business Integration component reference guide for detailed information about each resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide When you finish 1. Modify any other resource model settings that you want to change: Indications. See Customizing indications and eents on page 57. Tasks. See Specifying tasks for an indication on page 60. Schedules. See Customizing a schedule for a resource model. Logging. See Customizing data logging information on page Distribute the profile to which the resource model belongs. For more information, see Distributing profiles on page 43. Procedure You can perform this procedure from the Tioli command line or from the desktop. Command line: a profile. Use the wdmeditprf command to customize a resource model for Desktop: 1. Open the IBM Tioli Monitoring Profile window by following these steps: a. Double-click a policy region icon to open the policy region. b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only, double-click the appropriate management domain policy region icon to open the policy region. c. Double-click the profile manager icon to open the profile manager. d. Double-click the profile icon in which you want to customize a resource model. 2. Select the resource model that you want to customize from the IBM Tioli Monitoring Profile window. 3. Click Edit to open the Edit Resource Model window. 4. Click Parameters. 5. Select the type of parameter from the Name drop-down list in the Parameters window. 6. Add or delete the parameter alues as required by checking or clearing the boxes. 7. Click Apply Changes and Close to sae your changes. Customizing a schedule for a resource model Objectie To customize the schedule for a resource model so you can determine the time periods and days when monitoring takes place. 64 IBM Tioli Monitoring for Business Integration: User s Guide

89 Background information IBM Tioli Monitoring contains a scheduling feature that enables you to determine when monitoring takes place and specific scheduling rules. You can diide the oerall collection period into actie and inactie interals by applying one or more schedule rules. The scheduling rules enable you to define time periods on specific weekdays during which monitoring takes place. You can define any number of rules that enable you to set up a complex pattern of resource monitoring for a profile and coers the periods that you want to monitor. The scheduled times are always interpreted as local times, enabling you to set up a single rule that monitors the same local time period in different time zones. All times of eents or actiities reported from endpoints or gateways are also logged in the local time of the system from where they originated. Required authorization role admin Before you begin 1. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 40 for information. 2. Add a resource model that you can modify to each profile manager and profile. See Adding a custom resource model to a profile on page See the IBM Tioli Monitoring for Business Integration component reference guide for detailed information about each resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide When you finish 1. Modify any other resource model settings that you want to change: Indications. See Customizing indications and eents on page 57. Tasks. See Specifying tasks for an indication on page 60. Parameters. See Customizing parameters on page 63. Logging. See Customizing data logging information on page Distribute the profile to which the resource model belongs. For more information, see Distributing profiles on page 43. Procedure You can perform this procedure from the Tioli command line or from the desktop. Command line: a profile. Use the wdmeditprf command to customize a resource model for Desktop: 1. Open the IBM Tioli Monitoring Profile window by following these steps: a. Double-click a policy region icon to open the policy region. b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only, double-click the appropriate management domain policy region icon to open the policy region. Chapter 3. Working with resource models 65

90 c. Double-click the profile manager icon to open the profile manager. d. Double-click the profile icon in which you want to customize a resource model. 2. Select the resource model that you want to customize from the IBM Tioli Monitoring Profile window. 3. Click Edit to open the Edit Resource Model window. 4. Click Schedule to open the Scheduling window. Additional information: The Scheduling window contains the following groups of options: Schedule Sets the data collection period. By default, all resource models are set to always collect data. Schedule Rules Manages time interals during which the resource model is actie. Rule Editor Creates and edits schedule rules. 5. Clear the Always check box if you want to customize the schedule. 6. If you clear the Always check box, do the following to customize the schedule: a. Click New Rule in the Schedule Rules area. b. Type a name for the rule in the Rule Name text box of the Rule Editor panel. c. Select one or more items in the weekday list to specify the day or days on which you want the collections actie during the collection period. Additional information: Use the Shift or Ctrl key as necessary to select more than one day from the list. d. Set the Start Date and Stop Date for the collection actiity. e. Set the Start Time and Stop Time for the collection actiity or select the All Day check box. Additional information: Times are always interpreted as local time where the endpoint engine runs. Setting a time interal of 08:00 to 13:00 ensures that monitoring takes place between those times in all time zones to which you distribute the profile. f. Click Set Rule. Your new rule is displayed in the Schedule Rules list. Additional information: To display the details of any rule, select the rule in the Schedule Rules list. Its settings are displayed in the Rule Editor section of the window. If the Schedule Rules list contains more than one schedule rule, all the time interals are respected, and rules are combined by adding together the time periods they define. For example, if you specify a rule that requests monitoring between 8:00 and 14:00 eery day and another that requests all-day monitoring on Fridays, the sum of the two rules gies all-day monitoring only on Fridays, and monitoring between 8:00 and 14:00 on all other days. If the second rule instead requested monitoring from 12:00 to 18:00 on Fridays, the sum of the rules would gie monitoring between 8:00 and 18:00 on Fridays and between 08:00 and 14:00 on all other days. 7. Click Modify & Close to sae your rule and close the Scheduling window. 66 IBM Tioli Monitoring for Business Integration: User s Guide

91 Customizing data logging information Objectie To customize data logging information so you can log data collected by a resource model and write it in a local database. Background information You can iew the log data through the Web Health Console after you write it in a local database. You can store one of the following types of data in the database: Raw data Data written exactly as the resource model collects it. All the monitored alues are collected and copied in the database. Aggregated data Data collected and aggregated at fixed interals that you define (Aggregation Period). Only the aggregated alues are written in the database. The aggregated data is calculated on the basis of one or more of the following options: Maximum Minimum Aerage TEDW data TEDW Data aggregates the resource model data for use in the Tioli Enterprise Data Warehouse. Required authorization role admin Before you begin 1. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 40 for information. 2. Add a resource model that you can modify to each profile manager and profile. See Adding a custom resource model to a profile on page See the IBM Tioli Monitoring for Business Integration component reference guide for detailed information about each resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide When you finish 1. Modify any other resource model settings that you want to change: Indications. See Customizing indications and eents on page 57. Tasks. See Specifying tasks for an indication on page 60. Parameters. See Customizing parameters on page 63. Schedules. See Customizing a schedule for a resource model on page Distribute the profile to which the resource model belongs. For more information, see Distributing profiles on page 43. Procedure You can perform this procedure from the Tioli command line or from the desktop. Chapter 3. Working with resource models 67

92 Command line: a profile. Use the wdmeditprf command to customize a resource model for Desktop: 1. Open the IBM Tioli Monitoring Profile window by following these steps: a. Double-click a policy region icon to open the policy region. b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only, double-click the appropriate management domain policy region icon to open the policy region. c. Double-click the profile manager icon to open the profile manager. d. Double-click the profile icon in which you want to customize a resource model. 2. Select the resource model that you want to customize from the IBM Tioli Monitoring Profile window. 3. Click Edit to open the Edit Resource Model window 4. Click Logging to open the Logging window. 5. Select the Enable Data Logging check box in the Data Logging Settings pane to enable logging. Additional information: This enables the Aggregate Data and Historical Period options. 6. Perform the following steps to specify the aggregation rule applied to the data before it is written to the database: a. Set Hours and Minutes of the Aggregation Period to the required alues. b. Select one or more of the following functions to perform on the numerical data collected during the aggregation period before it is written to the database: Maximum Calculates and logs the peak alue in each aggregation period. Minimum Calculates and logs the lowest alue in each aggregation period. Aerage Calculates and logs the aerage of all alues in each aggregation period. Aerage is the default setting. 7. If you want to log the raw data instead of aggregate data, do the following: a. Clear the Aggregate Data check box. b. Select Raw Data. c. Optional: If Tioli Enterprise Data Warehouse is installed, you can check the TEDW Data option to store the raw data for use in Tioli Enterprise Data Warehouse. Note: You cannot choose both aggregate data and raw data at the same time, or aggregate data and TEDW data at the same time. 8. Set the Hours and Minutes of the Historical Period to the required alues. 9. Click Apply Changes and Close to sae your changes and close the Logging window. 68 IBM Tioli Monitoring for Business Integration: User s Guide

93 Managing profiles and resource models at endpoints Objectie To manage profiles and resource models after they are distributed to endpoints so you can maintain monitoring processes on those endpoints. Background information Not applicable. Required authorization role admin Before you begin 1. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 40 for information. 2. Distribute the profile. IBM Tioli Monitoring for Business Integration: WebSphere MQI See Populating the management domains on page 176 and Distributing profiles on page 43 for more information. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer See Subscribing resources to profile managers on page 40 for more information. 3. Add a resource model to a profile. See Adding a default resource model to a profile on page 41 and Adding a custom resource model to a profile on page 55 for information. 4. See the IBM Tioli Monitoring for Business Integration component reference guide for detailed information about each resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide When you finish Not applicable. Procedure You can perform this procedure from the Tioli command line only. Command line: Use the wdmcmd command to stop or restart IBM Tioli Monitoring on one or more endpoints from a gateway or serer. Use the wdmdistrib command to distribute a profile to one or more subscribers. Use the wdmeng command to stop or start profiles or resource models at endpoints or to delete profiles at endpoints. Use the wdmlseng command to return a list and the status of all resource models that hae been distributed on a specified endpoint. Use the wdmtrceng command to set the trace parameters of the IBM Tioli Monitoring engine at the endpoint. Chapter 3. Working with resource models 69

94 See the IBM Tioli Monitoring documentation for more information about the wdm commands. Managing IBM Tioli monitoring on gateways Objectie To manage IBM Tioli Monitoring on gateways so you can run monitoring processes on those gateways. Background information Not applicable. Required authorization role admin Before you begin 1. Add subscribers to a profile manager. 2. Distribute the profile. IBM Tioli Monitoring for Business Integration: WebSphere MQ See Populating the management domains on page 176 and Distributing profiles on page 43 for more information. IBM Tioli Monitoring for Business Integration: WebSphere MQ IntegratorIBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer See Subscribing resources to profile managers on page 40 for more information. 3. Add a resource model to a profile. See Adding a default resource model to a profile on page 41 and Adding a custom resource model to a profile on page 55 for information. 4. Distribute the profile.. 5. See the IBM Tioli Monitoring for Business Integration component reference guide for detailed information about each resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide When you finish Not applicable. Procedure You can perform this procedure from the Tioli command line only. Command line: Use the wdmmn command to stop or start selected IBM Tioli Monitoring processes on one or all gateways. Determining which resource models hae been distributed to endpoints Objectie To determine which resource models hae been distributed to an endpoint. 70 IBM Tioli Monitoring for Business Integration: User s Guide

95 Background information Open an endpoint window from the desktop to see if a monitor has been distributed to it. Required authorization role admin Before you begin 1. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 40 for information. 2. Distribute the profile. IBM Tioli Monitoring for Business Integration: WebSphere MQI See Populating the management domains on page 176 and Distributing profiles on page 43 for more information. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer See Subscribing resources to profile managers on page 40 for more information. 3. Add a resource model to a profile. See Adding a default resource model to a profile on page 41 and Adding a custom resource model to a profile on page 55 for information. 4. See the IBM Tioli Monitoring for Business Integration component reference guide for detailed information about each resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide When you finish Not applicable. Procedure You can perform this procedure from the Tioli desktop only. Desktop: 1. Open the Profile Manager window by following these steps: a. Double-click a policy region icon to open the policy region. b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only, double-click the appropriate management domain policy region icon to open the policy region. c. Double-click the profile manger icon to open the Profile Manager window. 2. Double-click the endpoint icon from the Subscribers area to open the endpoint window. 3. Double-click the monitoring profile icon to open the TME 10 Distributed Monitoring Profile Properties window, which lists the resource models distributed to the endpoint. Chapter 3. Working with resource models 71

96 Determining which resource models are running on endpoints Objectie To determine which resource models are running on an endpoint. Background information Use the Tioli command line to determine which monitors are running on an endpoint. Required authorization role admin Before you begin 1. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 40 for information. 2. Distribute the profile. IBM Tioli Monitoring for Business Integration: WebSphere MQI See Populating the management domains on page 176 and Distributing profiles on page 43 for more information. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer See Subscribing resources to profile managers on page 40 for more information. 3. Add a resource model to a profile. See Adding a default resource model to a profile on page 41 and Adding a custom resource model to a profile on page 55 for information. 4. See the IBM Tioli Monitoring for Business Integration component reference guide for detailed information about each resource model: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide When you finish Not applicable. Procedure You can perform this procedure from the Tioli command line only. Command line: Use the wdmlseng command to determine which resource models are running on an endpoint. For example, to iew the list of resource models on an endpoint, enter the following command. wdmlseng -e <endpoint> Refer to the IBM Tioli Monitoring User s Guide for more information. 72 IBM Tioli Monitoring for Business Integration: User s Guide

97 Chapter 4. Viewing resource model results with the IBM Tioli Monitoring Web Health Console This chapter proides an oeriew of the IBM Tioli Monitoring Web Health Console. For complete information on installing and working with the IBM Tioli Monitoring Web Health Console, see the latest ersion of the IBM Tioli Monitoring User s Guide. The IBM Tioli Monitoring Web Health Console runs on Netscape 6.x and Internet Explorer 6.x. You can use the IBM Tioli Monitoring Web Health Console for the following purposes: Checking, displaying, and analyzing the status and health of endpoints that hae distributed resource monitors Displaying an endpoint s real-time and historical data logged to the IBM Tioli Monitoring database Viewing online and historical data on endpoints as a follow-up to specific problems Starting and stopping the IBM Tioli Monitoring engine and indiidual resource models on a selected endpoint Remoing a profile from a selected endpoint Table 6 shows the goals and where to find the procedures for iewing resource model results in the Web Health Console. Table 6. Viewing resource model results in the Web Health Console Goal 1. Connect to the IBM Tioli Monitoring Web Health Console. Where to find procedures Connecting the IBM Tioli Monitoring Web Health Console on page 74 Resource health Status reflects the state of the endpoint displayed on the IBM Tioli Monitoring Web Health Console, such as running or stopped. Health is a numeric alue determined by resource model settings. You can also use the Web Health Console to work with real-time or historical data from an endpoint that is logged to the IBM Tioli Monitoring database. You can use the diagnostic and monitoring capabilities of the IBM Tioli Monitoring Web Health Console to perform targeted analysis of problems associated with indiidual endpoints when an eent is sent to the IBM Tioli Enterprise Console. Use the online and historical data to follow up specific problems with a single endpoint. The IBM Tioli Monitoring Web Health Console obtains eents and indications from endpoints. The IBM Tioli Monitoring Web Health Console displays the health of each potential problem as a numeric alue between 100 (perfect health) and zero (with zero meaning that the conditions for the corresponding eent are met). Intermediate alues show the percentage of occurrences currently registered with respect to the total number of occurrences needed to trigger an eent. Table 7 on page 74 contains an example of health alues. Copyright IBM Corp

98 Table 7. Health determination example Cycle CPU% Occurrences or holes H O H O O Occurrence count Health % Table 7 shows health percentage changes in steps of 25% because 4 occurrences were required to trigger an eent. If the indication required 5 occurrences, the health percentage would change by steps of 20%. Resource health is determined at the indication leel and passed up to the endpoint. The lowest health of any indication in a resource model is shown as the health of that resource model and the lowest health of any resource model installed on an endpoint is shown as the health of that endpoint. For example, if one indication on one resource model that is installed on an endpoint has a health of zero, the health of the endpoint is shown as zero. The required occurrences, cycle times, thresholds, and parameters for indications are defined when the resource model is created in the IBM Tioli Monitoring Resource Model Builder. Connecting the IBM Tioli Monitoring Web Health Console You can connect the IBM Tioli Monitoring Web Health Console to any Tioli management region serer or managed node and configure it to monitor any or all of the endpoints that are found in that region. The IBM Tioli Monitoring Web Health Console does not hae to be within the region itself, although it can be. To connect to the IBM Tioli Monitoring Web Health Console you need access to the serer on which the IBM Tioli Monitoring Web Health Console serer is installed and the IBM Tioli managed region on which you want to monitor health. All user management and security is handled through the IBM Tioli management enironment. This includes creating users and passwords as well as assigning authority. 74 IBM Tioli Monitoring for Business Integration: User s Guide

99 Chapter 5. Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse This chapter proides information on enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse. For a high leel oeriew, see the Road Map for Enabling Tioli Enterprise Data Warehouse for IBM Tioli Monitoring Products. Table 8 proides a list of the goals for enabling Tioli Enterprise Data Warehouse and shows where to locate information about the procedures for each goal. Table 8. Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse Goal Where to find procedures 1. Work with users. Working with users and user groups on page 78 Accessing the IBM Console on page 79 Creating an IBM Console user on page 80 Assigning roles to a user on page Work with user groups. Working with users and user groups on page 78 Creating a user group on page 81 Assigning users to a user group on page 81 Assigning user groups to a data mart on page 82 Copyright IBM Corp

100 Table 8. Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse (continued) Goal 3. Work with Tioli Enterprise Data Warehouse reports. Where to find procedures Managing Tioli Enterprise Data Warehouse reports on page 83 Running reports on page 84 Scheduling reports to run automatically on page 84 Modifying default settings for reports on page 85 Creating reports on page 86 Prepackaged reports for IBM Tioli Monitoring for Business Integration: WebSphere MQ on page 86 Prepackaged reports for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator on page 90 Prepackaged reports for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer on page 91 Tioli Enterprise Data Warehouse oeriew Tioli Enterprise Data Warehouse enables you to access underlying historical data from arious Tioli and customer applications. The infrastructure proides a set of extract, transform and load (ETL) processes that you use to extract and moe data from Tioli application data stores to a central data warehouse database. Tioli Enterprise Data Warehouse proides the following capabilities: An open architecture for storing, aggregating, and correlating historical data. In addition to the data collected by IBM Tioli software, Tioli Enterprise Data Warehouse has the flexibility and extensibility to enable you to integrate your own application data. Database optimizations for the efficient storage of large amounts of historical data and for fast access to data for analysis and report generation. The infrastructure and tools necessary for maintaining and iewing the collected data. These include the Tioli Enterprise Data Warehouse application, IBM DB2 Uniersal Database Enterprise Edition, the Data Warehouse Center, DB2 Warehouse Manager, and a user interface for creating and iewing reports. The ability to use your choice of data analysis tools to examine your historical data. In addition to the report interface, you can analyze your data using other products such as online analytical processing (OLAP), planning, trending, analysis, accounting, and data mining tools. The ability to control access to your historical data. You can keep data about multiple customers and data centers in one central data warehouse, but restrict access so that customers can see and work with data and reports based only on their data and not any other customer s data. You can also restrict an indiidual user s ability to access data. 76 IBM Tioli Monitoring for Business Integration: User s Guide

101 A zero-footprint client. Users can access Tioli Enterprise Data Warehouse reports from any system by using a Web browser. No special software is required on the user s system. Internationalization support. Not only is the report interface localized, application programmers can localize the data stored in the central data warehouse. Tioli Enterprise Data Warehouse consists of the following components: Control serer Central data warehouse Data marts Report interface Control serer The control serer contains the control database for Tioli Enterprise Data Warehouse from which you manage your data warehouse. The control serer has the following subcomponents: A serer that controls communication between the control serer, the central data warehouse serer, the data mart serer, and the report serer. The control database, which contains metadata for Tioli Enterprise Data Warehouse. The control serer uses the following parts of the IBM DB2 product, which you must install manually before installing the control serer. These parts are all automatically installed when you install IBM DB2 Uniersal Database Enterprise Edition on a Microsoft Windows system: DB2 Serer The Data Warehouse Center, a component that automates data warehouse processing. You can use the Data Warehouse Center to define the ETL processes that moe and transform data into the central data warehouse and the star schemas used by the data marts. Then, you can use the Data Warehouse Center to schedule, maintain, and monitor these processes. The warehouse agent, part of DB2 Warehouse Manager. For more information, refer to the Tioli Enterprise Data Warehouse Installation and Configuration Guide. Central data warehouse The central data warehouse is a DB2 database that contains the historical data for your enterprise. The system that hosts the central data warehouse is called the central data warehouse serer. The central data warehouse component uses IBM DB2 Uniersal Database Enterprise Edition, which you must install manually before installing the control serer. Data marts A separate DB2 database contains the data marts for your enterprise. Each data mart contains a subset of the historical data from the central data warehouse to satisfy the analysis and reporting needs of a specific department, team, customer, or application. The system that hosts this DB2 database is called the data mart serer. Although you can hae many data marts, you can hae only one data mart serer. Chapter 5. Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse 77

102 The data mart component requires IBM DB2 Uniersal Database Enterprise Edition, which you must install manually before installing the control serer. The warehouse pack for each component of IBM Tioli Monitoring for Business Integration creates a data mart whose structure is suitable for the report interface. The warehouse pack proides an extract, transform, and load (ETL) process called a data mart ETL that populates the star schemas associated with the data mart with data from the central warehouse. You can modify an existing data mart, or create new data marts that contain slightly different data, to address a reporting need specific to your situation. To modify or create a data mart, you must be familiar with database ETL processes and with the internal representation of a data mart as star schemas in the Tioli Enterprise Data Warehouse databases. For more information, refer to the Enabling an Application for Tioli Enterprise Data Warehouse document. Report interface The Tioli Enterprise Data Warehouse report interface (RPI) proides tools and a graphical user interface that other Tioli software products use to create and display reports. You can use the Tioli Enterprise Data Warehouse report interface to customize the reports that warehouse packs proide and to create new reports. You also use the report interface to control access to data marts and to the reports associated with a data mart. The system on which you install the report interface is called the report serer. Use the Work with Reports task group in the report interface to manage users, groups, and data marts for Tioli Enterprise Data Warehouse or to run, create, and iew Tioli Enterprise Data Warehouse reports. The following sections describe how to perform these tasks: Working with users and user groups Managing Tioli Enterprise Data Warehouse reports on page 83 Note: Some resource models act as proxies for remote computers. These resource models do not always log the full host name for the monitored computer and might use the IP address instead. When this information is uploaded to the Tioli Enterprise Data Warehouse, the same host is recognized as tow different components: an IP_HOST with ip_address as an attribute and an IP_INTERFACE. In the ETL1 processing for IBM Tioli Monitoring, some components are created two times; some are not created at all. The result is that these attributes are sometimes duplicated, depending on the order of the creation of the two host components. Working with users and user groups Check the IBM Customer Support site for aailable fix packs for the IBM Tioli Monitoring Warehouse Enablement Pack. You can iew patch descriptions and download patches from the following Customer Support site: ftp://ftp.software.ibm.com/software/tioli_support/patches/patches_1.1. This section describes tasks associated with managing user groups for Tioli Enterprise Data Warehouse. It includes the following topics: About users and user groups on page 79 Tioli Enterprise Data Warehouse roles on page IBM Tioli Monitoring for Business Integration: User s Guide

103 Accessing the IBM Console Creating an IBM Console user on page 80 Assigning roles to a user on page 80 Creating a user group on page 81 Assigning users to a user group on page 81 Assigning user groups to a data mart on page 82 About users and user groups You control access to data in Tioli Enterprise Data Warehouse data marts by specifying which user groups (collections of users) can run the reports that access the data in each data mart. Each user in a user group is gien access to all reports that access the data in the data marts to which that user group has access. By default, Tioli Enterprise Data Warehouse proides the TWHAdmin user group, which contains a single user: superadmin. You can customize the TWHAdmin user group for the needs of your enterprise. A user can be assigned to more than one user group. Tioli Enterprise Data Warehouse roles The following Tioli Enterprise Data Warehouse roles control access to tasks and actiities in the Work with Reports task group: Warehouse Security Administrator With this role, a user can create and manage groups and data marts. A user with this role controls access to data marts by assigning users to groups and by giing groups access to specific data marts. In effect, this role controls access to the Tioli Enterprise Data Warehouse data using user groups and data marts. Report roles control a user s ability to create and modify reports for the data marts his user groups can access. Assign only one of the following roles to each user: Adanced Report Author With this role, a user can create, modify, run, and delete public and their own personal reports, and sae the output of reports, both public and personal. Report Author With this role, a user can run and sae the output of public reports and create and modify their own personal reports. They can run public and personal reports, and create, modify, and delete personal reports. Report Reader Accessing the IBM Console With this role, a user can run public reports and iew the saed output of public reports. Objectie To open the IBM Console so you can use Tioli Enterprise Data Warehouse. Background information You perform all Tioli Enterprise Data Warehouse functions through the IBM Console. Access the IBM Console using a Web browser to connect to Tioli Enterprise Data Warehouse serer. Chapter 5. Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse 79

104 Required authorization role superadmin Before you begin Not applicable. When you finish You can create an IBM Console user as described in Creating an IBM Console user. Procedure To access the IBM Console, complete the following steps: 1. Start the Web browser. 2. Connect to the following URL: Creating an IBM Console user Assigning roles to a user of TEDW serer>/ibmconsole 3. Enter the default user, superadmin, and the default password, password. It is recommended that you change the default password after you log in. To change the password, click Administer Users and Role and select Manage Users. Objectie To create an IBM Console user. Background information Tioli Enterprise Data Warehouse opens using the IBM Console, which is also used by other Tioli software products. A user is gien access to tasks in the IBM Console based on the roles that are assigned to that user. One user can hae roles for dierse tasks including administering IBM Console users, managing Tioli Enterprise Data Warehouse user groups and data marts, running and iewing the output of Tioli Enterprise Data Warehouse reports, and performing tasks associated with other Tioli software products. Required authorization role superadmin Before you begin Access the IBM Console as described in Accessing the IBM Console on page 79. When you finish The Tioli Enterprise Data Warehouse online help guides you through additional tasks for managing users, such as updating or displaying the properties of a user and deleting a user. Procedure To create an IBM Console user, complete the following steps: 1. From the IBM Console, Click Administer Users and Roles Create a User. 2. Open the Task Assistant and follow the instructions proided in the online help to create a user. Objectie To assign roles to a user. 80 IBM Tioli Monitoring for Business Integration: User s Guide

105 Creating a user group Background information Not applicable. Required authorization role superuser Before you begin Not applicable. When you finish The Tioli Enterprise Data Warehouse online help guides you through additional tasks for managing users, such as updating or displaying the properties of a user and deleting a user. Procedure To assign a role to a user, complete the following steps: 1. From the IBM Console, select Administer Users and Roles and then Manage Users. 2. From the table of users, click the context menu icon of a user and select Properties. 3. Select the Roles tab. 4. Follow the instructions in the Task Assistant about assigning roles to the user. Objectie To create a user group. Background information Not applicable. Required authorization role Administration Authorizations Before you begin Not applicable. When you finish The Tioli Enterprise Data Warehouse online help guides you through additional tasks for managing user groups, such as updating or displaying the properties of a user group, adding users to a user group, and deleting a user group. Procedure To create a user group, complete the following steps: 1. From the IBM console, click Work with Reports Manage User Groups. 2. In the Manage User Groups window, click the context menu of Root and select Create. 3. Follow the instructions in the Task Assistant about creating user groups. Assigning users to a user group Objectie To assign users to user groups. Background information Not applicable. Chapter 5. Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse 81

106 Required authorization role Administration Authorizations Before you begin Not applicable. When you finish The Tioli Enterprise Data Warehouse online help guides you through additional tasks for managing user groups, such as updating or displaying the properties of a user group, adding or remoing users from a user group, and deleting a user group. Procedure To assign one or more users to a user group, perform the following steps: 1. From the IBM Console, click Work with Reports Manage User Groups. 2. In the Manage User Groups window, click the context menu icon of a group and select Properties. 3. Select the Users tab. 4. Follow the instructions in the Task Assistant about assigning users to user groups. Assigning user groups to a data mart Objectie To assign user groups to a data mart. Background information Grant access to only those user groups whose users need the data mart to perform tasks. Required authorization role Administration Authorizations Before you begin Not applicable. When you finish The Tioli Enterprise Data Warehouse online help can guide you through additional tasks for managing user groups, such as updating or displaying the properties of a user group, remoing users from a user group, and remoing data mart access from a user group. Procedure To assign user groups to a data mart, complete the following steps: 1. From the IBM Console, click Work with Reports Manage Data Marts. 2. In the Manage Data Marts window, in the Data Mart iew, click the context menu icon for the data mart that you want to change and click Properties. 3. Select the User Groups tab. 4. Follow the instructions in the Task Assistant about assigning user groups to a data mart. 82 IBM Tioli Monitoring for Business Integration: User s Guide

107 Managing Tioli Enterprise Data Warehouse reports Tioli Enterprise Data Warehouse reports display a static iew of the data in a data mart. Reports are proided by the warehouse pack for the IBM Tioli Monitoring for Business Integration components, along with the data mart required to collect the data used in the report. This section describes the following tasks: Running reports on page 84 Scheduling reports to run automatically on page 84 Modifying default settings for reports on page 85 Creating reports on page 86 For more information about working with reports, see the Tioli Enterprise Data Warehouse online help. Tioli software products using the Tioli Enterprise Data Warehouse can proide prepackaged reports that enable you to access specific information about your business enironment. All of these prepackaged reports are listed in the Manage Reports and Report Output task of the Work with Reports task group in the IBM Console. This includes reports from all Tioli software products that use the Tioli Enterprise Data Warehouse report interface. Tioli software products can also proide a different reporting interface. A Tioli Enterprise Data Warehouse report uses data from a single data mart. If you hae the appropriate role, you can also create additional reports or modify existing reports. Before you can create a new report or modify an existing report, you must understand the structure of the underlying warehouse data and of the operational data that is the source of that data. For information about the structure of data in the data mart and in the central data warehouse, refer to the Enabling an Application for Tioli Enterprise Data Warehouse document. For information about the specific data mart, star schema, and report mapping of IBM Tioli Monitoring for Business Integration components, refer to the following guides: IBM Tioli Monitoring for Business Integration: WebSphere MQ Warehouse Enablement Pack Implementation Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Warehouse Enablement Pack Implementation Guide IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Warehouse Enablement Pack Implementation Guide These guides are located in the following directories: tedw_apps_etl/ctq/pkg/110/doc directory on the IBM Tioli Monitoring for Business Integration Software CD. tedw_apps_etl/hmi/pkg/110/doc directory on the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Software CD. tedw_apps_etl/biw/pkg/110/doc directory on the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Workflow component Software CD. tedw_apps_etl/bix/pkg/110/doc directory on the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Software CD. Chapter 5. Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse 83

108 Running reports The Warehouse Enablement Pack Implementation Guides are also installed with the product in the $TWH_TOPDIR/apps/ctq/110/doc directory. For information about the Prepackaged reports, see the sections for the specific IBM Tioli Monitoring for Business Integration component (WebSphere MQ, WebSphere MQ Integrator, WebSphere Interchange Serer) in the following chapter: Prepackaged reports for IBM Tioli Monitoring for Business Integration: WebSphere MQ on page 86. Objectie To run a report using the report interface. Background information Not applicable. Required authorization role AdRepAuthRole, RepAuthRole, or RepReaderRole Before you begin Not applicable. When you finish The Tioli Enterprise Data Warehouse online help can guide you through additional tasks for reports, such as displaying the properties of a report and deleting a report. Procedure To run a report using the report interface, complete the following steps: 1. From the IBM Console, click Work with Reports Manage Reports and Report Output. 2. In the Manage Reports and Report Output window, in the Reports iew, click the context menu icon of a report and select Run. Scheduling reports to run automatically Objectie To automatically run reports. Background information Using the Tioli Enterprise Data Warehouse report interface, you can schedule a report to run automatically when the associated data mart is updated. This ensures that when you examine the output of the report, it displays the most recent data in the warehouse. Required authorization role AdRepAuthRole Before you begin Not applicable. When you finish The Tioli Enterprise Data Warehouse online help can guide you through additional tasks for reports, such as modifying or displaying the properties of a report and deleting a report. 84 IBM Tioli Monitoring for Business Integration: User s Guide

109 Procedure To schedule a report to run automatically when the associated data mart is updated, complete the following steps: 1. From the IBM Console, click Work with Reports Manage Reports and Report Output. 2. In the Manage Reports and Report Output window, in the Reports iew, click Reports. 3. Click the context menu icon of a report and select Properties. 4. Select the Schedule table, then select the check box. Modifying default settings for reports Objectie To modify default settings for report creation. Background information When you create or modify a report, you select predetermined alues for the time frame of the report. The predetermined alues of Peak Hours and Weekdays specified under Filtering in the Time page of report properties can be modified. Do this by modifying the information in the control database on the control serer. The default alue for Peak Hours is 9:00 am through 5:00 PM, or 0900 to This alue can be modified to reflect different peak hours if necessary. The default alue for Weekdays is Monday through Friday. This alue can also be modified. Table 9 contains the default filter alues for the time filters. Table 9. Default time filter names and alues TIME_FILTER_NAME TIME_FILTER_VALUES Peak hours hour(meas_hour) in (9,10,11,12,13,14,15,16,17) Weekdays dayofweek(meas_date) between 2 and 6 Required authorization role AdRepAuthRole Before you begin Not applicable. When you finish For additional information on the properties of the RPI.TimeFilters table, see Chapter 5, Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse, on page 75. Procedure To change the alues displayed in the report interface, perform the following steps: 1. Connect to the control database (TWH_MD). 2. Use an SQL statement similar to the following to modify the alues for Peak Hours or Weekdays in the RPI.TimeFilters table. The following example sets the Weekdays filter to represent Sunday through Thursday: Update RPI.TimeFilters set TIME_FILTER_VALUES ='dayofweek(meas_date) \ between 1 and 5' where TIME_FILTER_NAME ='Weekdays' Chapter 5. Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse 85

110 Creating reports Prepackaged reports After doing this, when you select a Weekdays filter for a report in the report interface, the data returned is for Sunday through Thursday. Note: There is no error-checking for the alues inserted into the tables for Peak Hours and Weekdays. Therefore, ensure that the information you insert into the tables is correct. You can sae a report that contains incorrect alues for these parameters without receiing an error message. The message is not generated until the report is run. Objectie To create a report. Background information You can receie a message that the name you specified is already in use, een if you do not hae access to the report with that name. Required authorization role AdRepAuthRole or RepAuthRole Before you begin Ensure that you use descriptie and meaningful names for the reports you create. Report names are unique across all users of Tioli Enterprise Data Warehouse. When you finish The Tioli Enterprise Data Warehouse online help guides you through additional tasks for reports, such as modifying or displaying the properties of a report and deleting a report. Procedure To create a report, from the IBM Console, click Work with Reports Create a Report. This section contains information about the prepackaged reports that the IBM Tioli Monitoring for Business Integration components proide. Prepackaged reports for IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere MQ proides the following prepackaged reports: CTQ Aailability Status for Channels Daily Shows the aerage percent of channels in all states (inactie, stopped, starting, retrying, initializing, binding, requesting, running, paused, stopping, and unknown) for all WebSphere MQ channels. The channels are grouped by host name, queue manager name, and channel name. CTQ Aailability Status for Queue Managers Daily Shows the aerage percent of queue managers in all states (up, down, unknown) for all WebSphere MQ queue managers. The queue managers are grouped by host name and queue manager name. CTQ Maximum Down Status for Queue Managers Daily Shows the top 25 queue managers with a maximum percent in a down 86 IBM Tioli Monitoring for Business Integration: User s Guide

111 state. The queue managers are grouped by queue manager name and host name. This report is an extreme case report. CTQ Maximum Outstanding Messages for Queues Daily Shows the top 25 queues with a maximum outstanding message count. The queues are grouped by queue name, queue manager name, and host name. This report is an extreme case report. CTQ Maximum Running Status for Channels Daily Shows the top 25 channels with a maximum percent in a running state. The channels are grouped by channel name, queue manager name, and host name. This report is an extreme case report. CTQ Message and Handle Summary for Queues Daily Shows the aerage outstanding message count, the aerage oldest message in minutes, and the aerage number of open input handles for all WebSphere MQ queues grouped by host name, queue manager name, and queue name. This report is a summary report. The following reports are for Workflow: BIW Status for WebSphere MQWF Serers Shows the serers with the highest aerage status up. This report is an extreme report. BIW Status for WebSphere MQWF Processes Shows the aerage ready and running status for processes. This report is a summary report. Examples of the prepackaged reports: Figure 3 on page 88 is an example of the CTQ Aailability Status for Queue Managers Daily report. Chapter 5. Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse 87

112 Figure 3. Aailability Status for Queue Managers Daily report example Figure 4 on page 89 is an example of the CTQ Maximum Outstanding Messages for Queues Daily report. 88 IBM Tioli Monitoring for Business Integration: User s Guide

113 Figure 4. Maximum Outstanding Messages for Queues Daily report example Chapter 5. Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse 89

114 Resource models that collect data for the prepackaged reports: Table 10 lists the IBM Tioli Monitoring for Business Integration: WebSphere MQ resource models that must be distributed to collect the data for each prepackaged report. Table 10 also lists the CIM classes you must use to create a resource model that collects the data for each prepackaged report. For more information about the IBM Tioli Monitoring for Business Integration: WebSphere MQ resource models and CIM classes, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Table 10. Resource models associated with the prepackaged reports Prepackaged report Resource model CIM classes CTQ Aailability Status for Channels Daily CTQ Aailability Status for Queue Managers Daily CTQ Maximum Down Status for Queue Managers Daily CTQ Maximum Outstanding Messages for Queues Daily CTQ Maximum Running Status for Channels Daily CTQ Message and Handle Summary for Queues Daily BIW Status for WebSphere MQWF Serers BIW Status for WebSphere MQWF Processes WebSphere MQ Channel WebSphere MQ Queue Manager WebSphere MQ Queue Manager WebSphere MQ Queue WebSphere MQ Channel WebSphere MQ Queue Workflow Status Monitor Workflow Process Status Monitor WebSphere_MQ_QueueMgr_12 WebSphere_MQ_Queue_12 WebSphere_MQ_Channel_12 WebSphere_MQ_QueueMgr_12 WebSphere_MQ_Queue_12 WebSphere_MQ_QueueMgr_12 WebSphere_MQ_Queue_12 WebSphere_MQ_QueueMgr_12 WebSphere_MQ_Queue_12 WebSphere_MQ_QueueMgr_12 WebSphere_MQ_Queue_12 WebSphere_MQ_Channel_12 WebSphere_MQ_QueueMgr_12 WebSphere_MQ_Queue_12 Workflow_Configuration_10 Workflow_Process_10 Workflow_Configuration_10 Workflow_Process_10 Prepackaged reports for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides the following Tioli Enterprise Data Warehouse star schemas, data marts, and reports. For more specific information about the star schemas, data marts, and reports, see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Tioli Enterprise Data Warehouse Enablement Pack Implementation Guide, which is located in the \Docs directory of the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator installation CD. Star schemas IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides the following star schemas: HMI Hourly WebSphere MQI Monitor Node star schema HMI Daily WebSphere MQI Monitor Node star schema HMI Weekly WebSphere MQI Monitor Node star schema HMI Monthly WebSphere MQI Monitor Node star schema HMI Hourly WebSphere MQI Component Status schema HMI Daily WebSphere MQI Component Status schema 90 IBM Tioli Monitoring for Business Integration: User s Guide

115 HMI Weekly WebSphere MQI Component Status schema HMI Monthly WebSphere MQI Component Status schema Data marts and reports This warehouse pack proides two data marts: HMI WebSphere MQI Monitor Node data mart and HMI WebSphere MQI Components data mart. HMI WebSphere MQI Monitor Node data mart: following star schemas: HMI Hourly WebSphere MQI Monitor Node star schema HMI Daily WebSphere MQI Monitor Node star schema HMI Weekly WebSphere MQI Monitor Node star schema HMI Monthly WebSphere MQI Monitor Node star schema This data mart uses the This data mart proides one prepackaged report, Metrics for WebSphere MQI Monitor Nodes. This summary report shows the aerage message rate, aerage byte rate, total byte count, and total message count for monitor nodes grouped by monitor node and host. HMI WebSphere MQI Components data mart: star schemas: HMI Hourly WebSphere MQI Component Status schema HMI Daily WebSphere MQI Component Status Schema HMI Weekly WebSphere MQI Component Status schema HMI Monthly WebSphere MQI Component Status schema This data mart uses the following This data mart proides the following prepackaged reports: HMI Status Down for WebSphere MQI Brokers This extreme case report shows the top 25 components with the highest daily aerage down status. HMI Status for WebSphere MQI Brokers This summary report shows the aerage status up, status down, status limited, and status unknown for brokers grouped by broker and host. HMI Status for WebSphere MQI Configuration Managers This summary report shows the aerage status up, status down, and status unknown for Configuration Managers grouped by host. HMI Status for WebSphere MQI User Name Serers This summary report shows the aerage status up, status down, and status unknown for User Name Serers grouped by User Name Serer and host. Prepackaged reports for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer The IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer resource model collects information about an InterChange Serer and stores the following information in Tioli Enterprise Data Warehouse: Aailability status of the InterChange Serer Memory utilization of the InterChange Serer Statistical information about each collaboration Statistical information about each adapter Chapter 5. Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse 91

116 You can use the reports deliered with IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer to obtain historical and trending information about your InterChange Serer. You can also use the Tioli Warehouse reporting tools to build customized reports using the data collected by IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides the following reports: BIX Aailability Status for InterChange Serers Daily This Summary report (table iew) shows the aerage percent in all states (up, down, and unknown) for all WebSphere InterChange Serers grouped by host and InterChange Serer. Use this report to monitor oerall InterChange Serer aailability. BIX Successful Eent Throughput for InterChange Serers This Extreme report (bar chart) shows the aerage percent of successful and failed collaboration eents for all WebSphere InterChange Serers grouped by host and InterChange Serer. Use this report to highlight WebSphere InterChange Serers that are processing eents. BIX Successful Access Throughput for InterChange Serers This Extreme report (bar chart) shows the aerage number of percent accesses for all WebSphere InterChange Serers grouped by host and InterChange Serer. Use this report to highlight WebSphere InterChange Serers that are processing accesses. BIX Memory Usage for InterChange Serers This Extreme report (bar chart) shows the aerage percent of memory used by all WebSphere InterChange Serers grouped by host and InterChange Serer. Use this report to highlight WebSphere InterChange Serers that are running low on memory. BIX Collaboration Status for InterChange Serers Daily This Summary report (table iew) shows the aerage number of collaborations in each non-running state (paused, down, congested). Use this report to highlight WebSphere InterChange Serers that hae the most problems running collaborations. BIX Adapter Status for InterChange Serers Daily This Summary report (table iew) shows the aerage number of adapters in each non-running state (paused, down). Use this report to highlight WebSphere InterChange Serers that hae the most problems running adapters. 92 IBM Tioli Monitoring for Business Integration: User s Guide

117 Chapter 6. Integrating with IBM Tioli Enterprise Console This chapter proides information about setting up the IBM Tioli Enterprise Console for use with IBM Tioli Monitoring for Business Integration software. If you do not hae the IBM Tioli Enterprise Console or do not want to hae IBM Tioli Monitoring for Business Integration software send eents to it, you do not need to use this information. Note: If you plan to track IBM Tioli Monitoring for Business Integration software objects using IBM Tioli Business Systems Manager, you must first configure IBM Tioli Enterprise Console to forward eents to IBM Tioli Business System Manager. For details on configuring IBM Tioli Enterprise Console to forward eents to IBM Tioli Business System Manager, see Configuring the eent serer on page 95. Table 11 proides a list of goals for setting up and using IBM Tioli Enterprise Console with IBM Tioli Monitoring for Business Integration software. The table also tells where to locate information about the procedures for each goal. Table 11. Setting up and using IBM Tioli Enterprise Console with IBM Tioli Monitoring for Business Integration software Goal 1. Configure the eent serer 2. Configure the eent console. (Optional) 3. Configure eent adapters. 4. Install the log file message formats. IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow Configuring the eent serer on page 95 Where to find procedures IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Configuring the Tioli Enterprise Console eent groups on page 102 Configuring the WebSphere MQ eent adapter on page 104 Chapter 12, Managing WebSphere MQ proxy mode z/os SMF records, on page 185 Not applicable Installing the MQSI eent adapter on page 106 Configuring the MQSI eent adapter on page 107 Configuring endpoints for MQ Integrator log file adapter support on page 108 Not applicable Not applicable Installing the MQ Integrator log file message formats on page 110 IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Not applicable Not applicable Copyright IBM Corp

118 Table 11. Setting up and using IBM Tioli Enterprise Console with IBM Tioli Monitoring for Business Integration software (continued) Goal 5. Start and stop adapters. 6. Minimize the number of eents that you can iew. 7. Run a task on an eent. IBM Tioli Monitoring for Business Integration: WebSphere MQ Starting and stopping a WebSphere MQ eent adapter on page 110 IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow Not applicable Filtering eents on page 113 Running a task on an eent on page 115 Where to find procedures IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Starting and stopping the MQSI eent adapter on page 112 Starting and stopping the WebSphere MQ Integrator log file adapter on page 113 IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Not applicable Not applicable Not applicable Running a task on an eent on page 115 IBM Tioli Enterprise Console oeriew In distributed computing enironments, it is essential to address eents and conditions that can lead to problems. The IBM Tioli Enterprise Console proides the tools for the following functions: Receiing eents from arious sources Processing eents using rules Grouping eents and delegating the groups selectiely to administrators Responding to eents automatically Viewing eents from multiple sources at a console The following concepts are important to eent management. For more information about the IBM Tioli Enterprise Console, refer to the Tioli Enterprise Console User s Guide. For a list of IBM Tioli Monitoring for Business Integration eent classes and rules, see Appendix C, Eent classes and rules, on page 339. Eents In the IBM Tioli Enterprise Console enironment, an eent is an object that has been created using data obtained from a source that is monitored by an IBM Tioli Monitoring eent adapter. It carries information about itself, including the eent class, eent identity, seerity, location (host where the eent originated), and description. Each eent is identified by a class name. Class names may ary and are defined by their respectie eent adapters. Sources of eents IBM Tioli Enterprise Console accepts eents from many sources. Typically, Tioli software is set up so that eents are sent in response to changes in 94 IBM Tioli Monitoring for Business Integration: User s Guide

119 Configuring the eent serer an application or system resource. For example, distributed monitors can be configured to send eents as well as report in other ways. Eent processing IBM Tioli Enterprise Console uses rules to process eents. A rule is made up of a set of logic statements. The rule makes decisions on what to do with the eent based on information proided in the eent, such as the eent class, eent name, seerity, location, and description. The logic for a rule proides one or more responses to the eent. A rule can drop insignificant eents, escalate important eents, create new eents, or respond to defined relationships of multiple eents (eent correlation). It can also close an old eent when a new eent indicates that the original condition is resoled. Eent grouping IBM Tioli Enterprise Console can filter eents into eent groups. These eent groups are typically organized by function but can also be configured by other criteria, such as location or organizational jurisdiction. Eent groups are especially useful for subdiiding all the IBM Tioli Enterprise Console eents so they are of a manageable size. Administrators can be assigned to one or more eent groups. Viewing eents IBM Tioli Enterprise Console includes a console where administrators can watch for incoming eents and respond to them. The eent console is a useful tool for managing by exception. The IBM Tioli Enterprise Console can filter out normal eents, respond automatically to anticipated problems, and forward only those eents that require human interention. Responses to eents IBM Tioli Enterprise Console normally can proide automatic responses to many common eents, either by running response programs or running Tioli tasks. For example, you can set a response program to respond to the eent that is receied when a database becomes unaailable. The specific response can be to inform an administrator or to attempt automatic restarts of the database, or a combination of both. IBM Tioli Monitoring for Business Integration proides a wide set of eents to report on conditions affecting your operations. IBM Tioli Monitoring for Business Integration: WebSphere MQ proides aailability and performance eents for MQ queue managers, channels, configuration eent queues, and workflow processes. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides aailability and performance eents for brokers, Configuration Managers, and User Name Serers. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides aailability eents for InterChange Serers. Objectie To configure the eent serer to recognize WebSphere MQ, WebSphere MQ Workflow, WebSphere MQ Integrator, and WebSphere InterChange Serer operations and to process rules concerning those eents. Chapter 6. Integrating with IBM Tioli Enterprise Console 95

120 Background information IBM Tioli Monitoring for Business Integration software includes a set of eent classes and rules specific to the software. The Configure Eent Serer task sets up the eent serer to process the eents releant to the software. Run this task once for each of the IBM Tioli Monitoring for Business Integration software that you are using and that has classes and rules installed on an eent serer. The Configure Eent Serer task performs the following actions as applicable to the software that you are using: Imports eent classes. Imports the base IBM Tioli Monitoring eent class, which is found in the Tmw2k.baroc file. Imports the rule sets that proide automated responses to many eents For more information, see Appendix C, Eent classes and rules, on page 339. Installs rule scripts Compiles the rule base to incorporate the new eent classes and the new rules. Optional: Loads the new rule base. Creates eent sources: IBM Tioli Monitoring for Business Integration: WebSphere MQ: - MQSERIES/MQSeries Eents - MQSERIES_SMF/MQSeries Statistics Eents IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: - MQSI_LOG/MQSI Log Eents - MQSI_EVENT/MQSI Publication Eents - Sentry/Sentry Eents Optional: Stops and restarts the eent serer to incorporate the specified rule base. The Configure Eent Serer task is in the following task libraries: For IBM Tioli Monitoring for Business Integration: WebSphere MQ, IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer, and IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow component IBM Tioli Monitoring Component Serices Tasks For IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator MQSI Eent Tasks You can configure more than one eent serer. IBM Tioli Monitoring for Business Integration: WebSphere MQ and IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer do not need to be installed on the eent serer in order to run this task. When you run this task to the eent serer, it will obtain needed files from the Tioli serer. See the reference guide for the IBM Tioli Monitoring for Business Integration software that you are using for more specific information about the Configure Eent Serer task for the software that you are using. Required authorization roles senior 96 IBM Tioli Monitoring for Business Integration: User s Guide

121 Before you begin You must hae IBM Tioli Enterprise Console installed. When you finish The following procedure is optional: IBM Tioli Monitoring for Business Integration: WebSphere MQ: Configure the eent console to create and assign the MQSeries eent group and the MQSeries Statistics eent group to an eent console. For more information, refer to the Configuring the Tioli Enterprise Console eent groups on page 102 and the IBM Tioli Enterprise Console User s Guide. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: Configure the eent console. For more information, see Configuring the Tioli Enterprise Console eent groups on page 102. Procedure 1. Open the policy region by using the following steps from the desktop depending on the software you are using: IBM Tioli Monitoring for Business Integration: WebSphere MQ: a. Right-click the Monitoring for WebSphere MQ icon. b. Select Configure Eent Serer from the icon pop-up menu. The Configure Eent Serer window opens. Chapter 6. Integrating with IBM Tioli Enterprise Console 97

122 Figure 5. Configure Eent Serer window for IBM Tioli Monitoring for Business Integration: WebSphere MQ Note: You cannot select the Set and Execute button until steps 1c and 1d are completed. c. Select the managed node hosting the eent serer to be configured in the Eent Serer node to configure list. d. Select the software for which the eent serer should be configured in the Product to configure list: IBM Tioli Monitoring for Business Integration: WebSphere MQ. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: a. Double-click the Monitoring for WMQI policy region. b. Double-click the MQSI Eent Tasks icon. c. Double-click the Configure Eent Serer task icon. d. Complete the Execute Task window. 98 IBM Tioli Monitoring for Business Integration: User s Guide

123 e. Click Execute & Dismiss to open the Configure Eent Serer window. Figure 6. Configure Eent Serer window for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer: a. Right-click the Monitoring for WebSphere ICS icon. b. Select Configure Eent Serer from the icon pop-up menu. The Configure Eent Serer window opens. Chapter 6. Integrating with IBM Tioli Enterprise Console 99

124 Figure 7. Configure Eent Serer window for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Note: You cannot select the Set and Execute button until steps 5c and 5d are completed. c. Select the managed node hosting the eent serer to be configured in the Eent Serer node to configure list. d. Select the software for which the eent serer should be configured in the Product to configure list: IBM Tioli Monitoring for WebSphere InterChange Serer 2. Complete the following fields in the Configure Eent Serer window: Rule Base Configuration Type of rule base configuration to be done. You can create a new rule base or update an existing rule base. Select one of the following: 100 IBM Tioli Monitoring for Business Integration: User s Guide Update Current Rule Base Specifies that you want to update an existing rule base. You must select the rule base to be updated from the Rule Bases field. Create New Rule Base From Existing Specifies that you want to create a new rule base, but that you want that rule base to be initialized with a copy of an existing rule base. You must type the name of the new rule base in the

125 New Rule Base Name field, and you must type the path to the new rule base in the New Rule Base Path field. You must select the initializing rule base from the Rule Bases field. Create New Rule Base Specifies that you want to create a new rule base, but that you do not want that rule base to be initialized with an existing rule base. You must type the name of the new rule base in the New Rule Base Name field, and you must type the path to the new rule base in the New Rule Base Path field. You cannot select a rule base in the Rule Bases field. This rule base contains the rules for the software. You hae to manually copy the default BAROC files. Rule Bases Existing rule bases. You can select one rule base from this list when you choose to update an existing rule base or when you choose to create a new rule base and hae it initialized from an existing rule base. New Rule Base Name Enter the name of a new rule base in this field: MQS, WICS. If you type the name of an existing rule base, this task issues a message and it will not update the existing rule base. New Rule Base Path Enter the path in which the new rule base is to be created. The task appends the name of the new rule base, as typed in the New Rule Base Name field, to this alue to determine the complete path of the new rule base. Eent Forwarding Eent forwarding information for your eent serer in regard to another eent serer or to IBM Tioli Business Systems Manager. Eent forwarding is an optional feature. If these fields are left blank, the eent serer rule base is created or updated as requested, but eent forwarding is not configured or changed. In case of forwarding eents to another serer, if you type either or both alues, the tec_forward.conf file is updated with your new alues. Host Name Enter one or more host names to which eents are to be forwarded. To specify more than one host name, separate each host name with a comma. Port Enter one or more port numbers to be used for eent forwarding. To specify more than one port, separate each port number with a comma. Forward to TBSM Indicates whether a rule is loaded to forward eents from discoered components to IBM Tioli Business Systems Manager as follows: IBM Tioli Monitoring for Business Integration: WebSphere MQ: This option is not aailable because all IBM Tioli Business Systems Manager rules are always loaded. Chapter 6. Integrating with IBM Tioli Enterprise Console 101

126 IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow component: This option is not aailable because this software does not integrate with IBM Tioli Business Systems Manager. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: If selected, indicates that a rule is loaded to forward eents from discoered components to IBM Tioli Business Systems Manager. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer This option is not aailable because this software does not integrate with IBM Tioli Business Systems Manager. IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow component Rule Base Actiation These selections enable you to control when your updated rule base becomes actie. Do Not Actiate Creates or updates the rule base but does not upload the rule base into the eent serer. Use this option if you want to reiew rule base changes before you actiate them. Load Rule Base Only Creates or updates the rule base and loads it into the eent serer. The new rule base is actie when the eent serer is restarted. Load Rule Base and Restart Serer Creates or updates the rule base, loads it into the eent serer, and restarts the eent serer. 3. Click Set and Execute. A confirmation window displays the job status after the task completes. Configuring the Tioli Enterprise Console eent groups Objectie To configure the IBM Tioli Enterprise Console eent console so you can iew eents for the following IBM Tioli Monitoring for Business Integration software: IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer This task is optional. Background Information You must add an eent group with eent source filters to each eent console to see the IBM Tioli Monitoring for Business Integration eents on the Tioli eent consoles. Required Authorization Role None. 102 IBM Tioli Monitoring for Business Integration: User s Guide

127 Before You Begin Configure the eent serer. For more information, see Configuring the eent serer on page 95 When You Finish You will see the new eent group when you use the Eent Viewer function of the IBM Tioli Enterprise Console Version 3.7 console. Procedure To configure an IBM Tioli Enterprise Console eent console to display IBM Tioli Monitoring for Business Integration eents. This procedure shows an example of configuring an eent group for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. 1. Connect to your IBM Tioli Enterprise Console serer by doing the following: a. Open the eent console by typing tec_console at the command prompt on a machine with IBM Tioli Enterprise Console installed. b. Fill in the information to connect to your IBM Tioli Enterprise Console serer. 2. Click Windows Configuration in the IBM Tioli Enterprise Console window. 3. Right-click Eent Groups in the Configuration window. 4. Select Create Eent Group. 5. Fill in the fields as follows: Name: Proide a name for this eent group, for example: MQ Eents. Description: Proide a description for this eent group, for example: IBM Tioli Monitoring for Business Integration: WebSphere MQ eents. 6. Click OK. 7. Create an eent filter to capture just the eents for the software you are using by doing the following: a. Right-click on your newly created eent group, for example, MQ eents. b. Choose Create Filter. 8. Complete the fields in the window as follows: Name Type a name for this filter, for example: All MQ Eents. Description Type a description for this filter, for example: Eents sent by IBM Tioli Monitoring for Business Integration: WebSphere MQ. 9. Click Add Constraint. 10. Fill in the Add Constraint fields as follows: Attribute: Class Operator: Like (LIKE) Value %MQ_% (to iew eents sent from the MQ eent adapters) or %WebSphere_MQ_% (to iew eents from the MQ resource models) Chapter 6. Integrating with IBM Tioli Enterprise Console 103

128 Additional Information: To create an eent group for MQI use Value %MQSI_%. To create an eent group for MQWF, use Value %MQWF_%. To create an eent group for WICS, use Value WICS_%. 11. Click OK. 12. Click OK (again). 13. Assign the new eent group to your eent console by doing the following: a. Expand the Consoles tree. b. Expand the console to which you want to assign the new eent group. c. Right click Eent Groups and choose Assign Eent Group. d. Click Assign Groups. e. Choose the eent group ( MQ Eents and assign the appropriate roles. f. Click OK. Configuring the WebSphere MQ eent adapter Objectie To configure the WebSphere MQ eent adapter for each queue manager from which you want to receie WebSphere MQ eents. Background information The eent adapter retriees WebSphere MQ eents and forwards formatted eents to the eent console. For more information about these eents, see Appendix C, Eent classes and rules, on page 339. Trace and error information related to running the eent adapter is written in the trace_tecad_mqseries._qmgrname_1.log file, where qmgrname is the name of the queue manager. The trace_tecad_mqseries._qmgrname_1.log file is located in the $LCF_DATDIR/LCFNEW/CTQ/logs directory on the endpoint for which the queue manager is located. When the log file reaches 500KB, the log file is renamed to trace_tecad_mqseries._qmgrname_2.log and a new log file is started. The contents of the preiously rolled oer log file is discarded. Configuring the WebSphere MQ eent adapter performs these actions: Clears and then deletes each of the following system eent queues if they exist: SYSTEM.ADMIN.QMGR.EVENT SYSTEM.ADMIN.PERFM.EVENT SYSTEM.ADMIN.CHANNEL.EVENT For each of the deleted queues, defines a queue alias with the same name. Defines a new local queue (EVENTQ by default) using the queue name you specified when you configured the eent adapter. The alias queues and the new local queue act as a single queue from which the eent adapter retriees WebSphere MQ eents. The WebSphere MQ eent adapter requires exclusie access to the alias queues and the new local queue. For the eent adapter to work properly, the eent adapter must be the only application that remoes messages from these queues. Notes: 1. If you reconfigure an eent adapter, stop and start the appropriate eent adapter to incorporate the changes. 2. You can configure an eent adapter to send eents from the endpoint through the gateway to the eent serer or to send eents directly to the eent serer. 104 IBM Tioli Monitoring for Business Integration: User s Guide

129 3. For information about configuring an eent adapter for proxy mode z/os, refer to the IBM Tioli Monitoring for Business Integration Installation and Setup Guide. 4. When you reconfigure an eent adapter, some eents can be lost because the queues are cleared. Required authorization roles MQS_senior or MQS_domain_name_senior admin Before you begin Start the queue manager if it is not already running. When you finish If you are reconfiguring an adapter, restart the adapter to make the changes effectie. For information about how to start and stop a WebSphere MQ eent adapter, see Starting and stopping a WebSphere MQ eent adapter on page 110. Procedure 1. Do one of the following: From the queue manager icon pop-up menu, click Eent Adapter Tasks Configure Eent Adapter to open the MQS Configure TEC Adapter window. OR From the Action menu on the Queue Manager Control Center window, click Eent Adapter Tasks Configure Eent Adapter to open the MQS Configure TEC Adapter window. Note: Configuring the eent adapter from the Queue Manager Control Center enables you to configure the eent adapter on multiple queue managers at the same time. This method is useful if you want all eent adapters to hae the same configuration settings. Chapter 6. Integrating with IBM Tioli Enterprise Console 105

130 Figure 8. Configure Eent Adapter window 2. Complete the fields, referring to the online help or the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide for additional information. Note: Only non-tme IBM Tioli Enterprise Console eents are supported on OS/400 systems. a. Configure the OS/400 WebSphere MQ eent adapters as follows: 1) Select the No check box next to Send eents through gateway? question. 2) Type the full TEC serer host name in the TEC Serer Hostname field. 3) Type the required TEC Serer Port Number in the TEC Serer Port Number field. b. Select Properties from the Edit drop down menu. c. Configure the resource model profiles as follows: 1) Click Fail-oer to set the Profile Properties to use non-tme. 2) Type the full Eent Serer address:port number. 3. Click Set and Execute. Installing the MQSI eent adapter Objectie To install the MQSI eent adapter. This task applies only to IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. Background information Brokers publish eent messages to report configuration changes, state changes, and user actions. The MQSI Eent Adapter proides a way to generate Tioli eents 106 IBM Tioli Monitoring for Business Integration: User s Guide

131 based on the broker publication topics. The MQSI Eent Adapter is not used with configuration managers or user name serers. For Windows platforms, this task performs the following actions: Installs a Windows serice for the MQSI eent adapter for this broker Establishes an initial topic set that consists of broker configuration messages only Establishes an adapter enironment based on the broker s queue manager name For UNIX platforms, the task performs the following actions: Establishes an initial topic set that consists of broker configuration messages only Establishes an adapter enironment based on the broker s queue manager name For z/os systems running in proxy mode, see the IBM Tioli Monitoring for Business Integration Installation Guide for instructions on creating or modifying the proxy mode z/os MQSI eent adapter configuration file. Required authorization role mqsi_senior Before you begin Ensure that the Adapter Configuration Facility is installed on all gateways where you want to install the MQSI eent adapter. For information, see Configuring endpoints for MQ Integrator log file adapter support on page 108. When you finish Configure the MQSI eent adapter. For more information, see Configuring the MQSI eent adapter. Procedure To install the MQSI eent adapter, run the Install MQSI Eent Adapter task in the MQSI Eent Tasks library. This task does not hae a window; it performs a predefined set of functions. This task installs the adapter based on the operating system in which it will be run. Configuring the MQSI eent adapter Objectie To configure an MQSI eent adapter. Background information The MQSI eent adapter is primarily intended to report broker configuration changes. Howeer, you can use configure the adapter to report other broker topics as well. Note: This task is not aailable for proxy mode z/os. You must modify the MQSI eent adapter configuration file (located in the $USS_BINDIR/TME/MQSI/utils directory) manually. For information, see the IBM Tioli Monitoring for Business Integration Installation and Setup Guide. Required authorization role mqsi_senior Chapter 6. Integrating with IBM Tioli Enterprise Console 107

132 Before you begin Install the MQSI eent adapter. For more information, see Installing the MQSI eent adapter on page 106. When you finish Start the MQSI eent adapter. See Starting and stopping the MQSI eent adapter on page 112 for more information. Procedure Follow these steps to perform this procedure from the Tioli desktop: 1. From the Tioli desktop, double-click the Monitoring for WMQI policy region. 2. Double-click the MQSI Eent Tasks icon. 3. Double-click the Configure MQSI Eent Adapter task icon and complete the Execute Task window. 4. Click Execute & Dismiss to open the Configure MQSI Eent Adapter window. Complete the following fields: Size of TraceLog File Changes maximum size of the trace log. There can be 2 files: the current log and the old log. The minimum/default size is and the maximum size is Size of InputBuffer Changes the maximum size of the input buffer used to receie eents. The minimum/default size is 16000, and maximum size is Increase the size of the buffer as the messages flows become more complex. If the message No message arried: 2079 is logged, this indicates that the size of the input buffer should be increased. Subscription Topics This field consists of the set of default subscription topic choices. You can select one or more topics. 5. Click Set and Execute to start the task. The Configure Eent Serer Output window displays the job status after the task is completed. Configuring endpoints for MQ Integrator log file adapter support Objectie To configure the Tioli log file adapter for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. Background Information WebSphere MQ Integrator components report operational status and changes by writing messages to the system logs (for example: Eent log on Windows, syslog on UNIX). Information from these logs is collected and reported using the Tioli log file adapter. For a complete description of the Tioli log file adapter and how to use it, refer to the IBM Tioli Enterprise Console Adapter s Guide. The log file adapter is aailable for distributed platforms. Required Authorization Role mqsi_senior 108 IBM Tioli Monitoring for Business Integration: User s Guide

133 Before You Begin The log file adapters are packaged with the IBM Tioli Enterprise Console Adapter Configuration Facility. You must use the Adapter Configuration Facility to install these adapters on endpoints. The Tioli endpoint adapters are installed by creating an adapter configuration profile that adds entries for the adapters you want to install, and distributing the adapter configuration profile to a list of endpoint subscribers, which is a similar process to any profile distribution using the Tioli desktop. The Adapter Configuration Facility must be installed on the same managed node as the endpoint gateway so that adapters and adapter-related files can be distributed to the endpoints. Therefore, it is important to install the Adapter Configuration Facility on the Tioli serer and eery managed node that is configured as an endpoint gateway throughout the Tioli Region. See the IBM Tioli Enterprise Console User s Guide for more information about installing the Adapter Configuration Facility. When You Finish See Installing the MQ Integrator log file message formats on page 110. Procedure Use the following steps to install a log file adapter on a Tioli endpoint: 1. Create a policy region or select an existing policy region on the Tioli Desktop. 2. Add ACP as a managed resource type for the policy region. Right-click the policy region and select Managed Resources. Set ACP as a managed resource in the Set Managed Resources window for the policy region where you will be installing the adapters. 3. Create a profile manager inside the policy region, specifying the Dataless Endpoint Mode option. For information on creating a profile manager, see Creating profile managers and profiles on page From within the profile manager: a. Create a profile. b. In addition to naming the profile, specify ACP as the profile type. c. In the adapter configuration profile, add an entry for each adapter to install on the endpoints. Note: Log file adapters are platform-specific (for example, tecad_logfile_hpux10 and tecad_logfile_solaris2). If your endpoints are running on multiple platforms, some on HP-UX 11 and some on Solaris, for example, and you want to monitor their system log files, you must create an adapter configuration profile for each platform and distribute them to the appropriate endpoints. Use the tecad_win adapter for Windows NT and Windows After selecting the adapter from the Add Adapter Configuration window, you are placed in edit mode so that you can change default settings for the adapter. Accept the default settings. 6. Create endpoint subscribers for the adapter configuration profile. 7. Distribute the adapter configuration profile to the subscribing endpoints. The adapters defined in the adapter configuration profile will be installed and started on the subscribing endpoints. Chapter 6. Integrating with IBM Tioli Enterprise Console 109

134 Installing the MQ Integrator log file message formats Objectie To install the log file message formats for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. Background information In order for the Tioli log file adapter to generate eents for WebSphere MQ Integrator log messages, the log file adapter format file must be updated to include WebSphere MQ Integrator message formats. To perform this update, you must run the Install Logfile Message Formats task in the MQSI Eent Tasks task library. This task performs the following actions: Adds message format descriptions to the log file adapter for WebSphere MQ Integrator messages Generates a new CDS file for the log file adapter Stops and restarts the Tioli log file adapter if it is currently running The log file message formats are aailable on distributed platforms. Required authorization role mqsi_admin Before you begin Configure the log file adapter. For more information, see Configuring endpoints for MQ Integrator log file adapter support on page 108. When you finish Start the log file adapter, using the Start Logfile Adapter task. Use the Configure Logfile Adapter task to enable or disable logging for a component. For more information, see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide. Install and configure the MQSI eent adapter for broker eents. For more information, see Installing the MQSI eent adapter on page 106. Procedure Use the Install Logfile Message Formats task. For more information about this task, see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide. When running the task, the list of task endpoints consists of WebSphere MQ Integrator components. Since there is only one instance of the log file adapter per machine, running this task against any WebSphere MQ Integrator component on that machine updates the log file adapter format file for all WebSphere MQ Integrator components on that machine. Starting and stopping a WebSphere MQ eent adapter Objectie To start and stop a WebSphere MQ eent adapter. Background information For resources running on proxy mode z/os system, the Start Eent Adapter task issues a proxy mode z/os command to start the JCL PROC member TECAD, which must be properly configured on the target proxy mode z/os system. For more information on this JCL, refer to the IBM Tioli Monitoring for Business 110 IBM Tioli Monitoring for Business Integration: User s Guide

135 Integration Installation and Setup Guide. Use the Stop Eent Adapter task to stop an eent adapter on a proxy mode z/os system running in proxy mode only if you used the Start Eent Adapter task to start the eent adapter. If you start the eent adapter by submitting the TECAD JCL on proxy mode z/os, stop the eent adapter from the proxy mode z/os console. When the Tioli software on an endpoint is restarted (because of a system reboot or any other reason), eent adapters on the endpoint or on a proxy mode z/os system are not automatically restarted by default. You must manually restart the eent adapters on the endpoints or customize the WebSphere MQ Queue Manager resource model s Queue Manager Eent Adapter Not Running indication to run the Start TEC Adapter task. See Starting and stopping a WebSphere MQ eent adapter on page 110. On a proxy mode z/os system, you can use the IHSMSTEC CLIST to automatically restart the eent adapter. For more information, see IHSMSTEC CLIST on page 366. When the TCP/IP stack on a proxy mode z/os system is stopped and restarted, you must also stop and restart the eent adapter for WebSphere MQ on the proxy mode z/os system. For information about starting the eent adapter from the command line, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Required authorization roles MQS_admin or MQS_domain_name_admin admin Before you begin Not applicable. When you finish Not applicable. Procedure You can perform this procedure from either the Tioli command line or the desktop. Desktop: From the appropriate queue manager icon pop-up menu, click Eent Adapter Tasks Start or Eent Adapter Tasks Stop. OR From the Action menu on the Queue Manager Control Center window, click Eent Adapter Tasks Start Eent Adapter or Eent Adapter Tasks Stop Eent Adapter. Command line: You can also stop all eent adapters from the command line. Refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide for information on stopping and starting the eent adapter from a command line. Additional Information: WebSphere MQ enables you to forward WebSphere MQ eents from one queue manager to another queue manager. You can use this WebSphere MQ capability to forward WebSphere MQ eents for a queue manager running on a platform where IBM Tioli Monitoring for Business Integration: WebSphere MQ cannot be installed to a queue manager where the eents can be processed. For example, you can forward the eents for a queue manager running Chapter 6. Integrating with IBM Tioli Enterprise Console 111

136 on a VSE/ESA system to a queue manager on an AIX managed node where the eents can be processed. When you iew the forwarded eents on an eent console, the forwarded eent contains the host name or address of the machine on which the WebSphere MQ eent adapter is running. The name is displayed in the origin Hostname text field. For these eents, use the name of the queue manager to determine where the eent originated. Refer to the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Reference Guide Version for more information on the Eent Adapter commands. Starting and stopping the MQSI eent adapter Objectie To start or stop the MQSI eent adapter. Background information Brokers publish eent messages to report configuration changes, state changes, and user actions. The MQSI Eent Adapter proides a way to generate Tioli eents based on the broker publication topics. The MQSI Eent Adapter is not used with configuration managers or user name serers. The eent adapter is not automatically started during adapter installation. You will need to start the adapter following the installation process. The adapter will start automatically on distributed platforms for Windows operating systems, but not for UNIX operating systems. For proxy mode z/os there is no restarting facility. Required authorization role admin Before you begin Install the log file adapter. For more information, see Configuring endpoints for MQ Integrator log file adapter support on page 108. When you finish Not applicable. Procedure Follow these steps to perform this procedure from the Tioli desktop: 1. From the Tioli desktop, double-click the Monitoring for WMQI policy region. 2. Double-click the MQSI Eent Tasks icon. 3. Double-click the Start MQSI Eent Adapter or Stop MQSI Eent Adapter task icon. 4. Click Set and Execute to start the task. You can also use options on the broker object menu to start and stop the MQSI eent adapter. For more information about using the objects, see Chapter 17, Working with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects, on page IBM Tioli Monitoring for Business Integration: User s Guide

137 Starting and stopping the WebSphere MQ Integrator log file adapter Filtering eents Objectie To start or stop the log file adapter. Background information WebSphere MQ Integrator components report operational status and changes by writing messages to the system logs (for example: Eent log on Windows, syslog on UNIX). Information from these logs is collected and reported using the Tioli log file adapter. Required authorization role admin Before you begin Install the log file adapter. For more information, see Configuring endpoints for MQ Integrator log file adapter support on page 108. When you finish Not applicable. Procedure Follow these steps to perform this procedure from the Tioli desktop: 1. From the Tioli desktop, double-click the Monitoring for WMQI policy region. 2. Double-click the MQSI Eent Tasks icon. 3. Double-click the Start Logfile Adapter or Stop Logfile Adapter task icon and complete the Execute Task window. 4. Click Set and Execute to start the task. You can also use options on the WebSphere MQ Integrator component object menus to start and stop the log file adapter. For more information about using the objects, see Chapter 17, Working with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects, on page 227. Objectie To minimize the number of eents that you can iew for the following software: IBM Tioli Monitoring for Business Integration: WebSphere MQ, including the Workflow component IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Background information You might not want certain types of eents to appear on your eent consoles because you regard them as harmless or unlikely to require action. You can filter eents in two ways: Choose not to send them to the Tioli Enterprise Console serer Choose not to iew eents at the Tioli Enterprise Console Not sending eents to the Tioli Enterprise Console serer: IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: You can specify that an eent not be sent to the eent serer. For example, you specify filter criteria in one or more of the configuration files in Table 12 on page 114 Chapter 6. Integrating with IBM Tioli Enterprise Console 113

138 114. Table 12. Eent filter examples for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Eent adapter MQSI Eent Adapter Configuration file manager>.conf Tioli log file adapter tecad_nt.conf (Windows and ACF Version 3.7) tecad_win.conf (Windows and ACF Version 3.7) tecad_logfile.conf (UNIX) One of the following directories contains the configuration files for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: $LCF_BINDIR/../TME/TEC/adapters/etc $LCF_BINDIR../TME/MQSI/utils $USS_BINDIR/TME/MQSI/utils (for proxy mode z/os) The Configure Logfile Adapter task creates filters for the Tioli log file adapter. You can add other filters. The Configure Logfile Adapter task creates filters for the Tioli log file adapter. You can add other filters. Refer to the IBM Tioli Enterprise Console Rule Builder s Guide for more information. You can also create new rules to exclude the eent. In this case, the eent is forwarded to the eent serer, but it is remoed by the rules engine. Refer to the IBM Tioli Enterprise Console Rule Builder s Guide for more information. Here is an example of a filter statement: FilterMode=OUT Filter:Class=MQSI_BIP2001_Start_Component;mqsi_CompName= Configuration Manager Refer to the IBM Tioli Enterprise Console Adapter s Guide for more information. IBM Tioli Monitoring for Business Integration: WebSphere MQ: Not iewing eents at the Tioli Enterprise Console: You can create new rules to exclude the eent. In this case, the eent is forwarded to the eent serer, but it is remoed by the rules engine. Refer to the IBM Tioli Enterprise Console Rule Builder s Guide for more information. Required authorization roles Not applicable. Before you begin Not applicable. When you finish Stop and restart the eent adapter. Procedure Filter eents generated by the Eent Adapter using control statements in the Eent Adapter configuration file. 114 IBM Tioli Monitoring for Business Integration: User s Guide

139 On distributed platforms, the Eent Adapter configuration file is named tecad_mqseries.qmgrname.cfg, where qmgrname is the name of the queue manager. It is located in the $LCF_BINDIR/../../generic_unix/TME/MQS/teccfg directory. On z/os, the Eent Adapter configuration file is a member of a Partitioned Data Set (PDS) of the customer s choosing, and has the same name as the queue manager. The configuration file is created by the Configure Eent Adapter task and exists only after you hae run this task at least once for a specific queue manager. Any filter statements you added to the configuration file are presered when you reconfigure an eent adapter. Use one or more of the following techniques to filter eents: Specify filtering templates that allow eents to be sent using the FilterMode statement in conjunction with the Filter statement. For example, with FilterMode=IN Filter:Class=MQSI_BIP2001_Start_Component;mqsi_CompName= Configuration Manager only eents of the MQSI_BIP2001_Start_Component class and whose component name is Configuration Manager are sent. Specify filtering templates that preent eents from being sent. using the FilterMode statement in conjunction with the Filter statement. For example, with FilterMode=OUT Filter:Class=MQSI_BIP2001_Start_Component;mqsi_CompName= Configuration Manager all eents are sent except eents of the MQSI_BIP2001_Start_Component class and whose component name is Configuration Manager. Since OUT is the default, you can also filter this way using the Filter statement without the FilterMode statement. Use wildcard filtering to include a collection of eents in the filtering template. On z/os, the asterisk indicates zero or more missing characters. The question mark indicates one missing character. For example, with FilterMode=OUT Filter:Class=MQ_*_NOT_AUTHORIZED;QMgrName=QM?1 all eents are sent except those whose class name starts with MQ_ and ends with _NOT_AUTHORIZED, and that are from a queue manager named QM11, QM21, or QMA1. On distributed, the question mark is not used, and the asterisk appears only at the end of the text. The filter statement uses regular expressions. For example, with FilterMode=IN Filter:Class=MQ_CHANNEL_* Running a task on an eent only eents whose class name begins with MQ_CHANNEL_ are sent. Objectie Running a task on a WebSphere MQ or WebSphere Interchange Serer eent. Background information You can run the tasks proided in the MQSeries TEC Tasks task library or the WICS Eent Console Tasks task library on the resources identified by specific Chapter 6. Integrating with IBM Tioli Enterprise Console 115

140 eents on your eent console. For more information about running a task from the eent console, refer to the IBM Tioli Enterprise Console User s Guide. IBM Tioli Monitoring for Business Integration: WebSphere MQ: The MQSeries TEC Tasks task library is added to the Monitoring for WebSphere MQ policy region during installation. You can run a task from the MQSeries TEC Tasks task library only on eents that come from the MQSERIES eent source. You cannot run a task from the MQSeries TEC Tasks task library on eents from the MQSERIES_SMF eent source. The MQSeries TEC Tasks task library includes the following tasks: Display Channel Attributes Displays the attributes of one or more channels. Display Queue Manager Display information about a queue manager, which can help you diagnose possible problems. Ping Queue Manager Checks the status of a queue manager. Reset Channel Resets the message sequence number for a WebSphere MQ channel. Start DLQ Handler Starts the dead-letter queue handler. Stop DLQ Handler Stops the dead-letter queue handler. Start Channel Restarts a channel that has stopped unexpectedly. Start Alternate Channel Starts an alternate channel with the same XMIT queue name as a channel that has gone down. Start Channel Initiator Starts the channel initiator for a queue manager. Start Channel Listener Starts a listener for a queue manager. Start Command Serer Starts a command serer for a queue manager. Start Queue Manager Restarts a queue manager that has stopped unexpectedly. Start Trigger Monitor For a distributed system only, starts a trigger monitor named amqstrm. Note: If you want to write the trigger monitor messages to a file, run the Start Trigger Monitor task from the Control Tasks task library. This option is not aailable when you run the Start Trigger Monitor task from the eent console. Stop a Channel Performs an orderly shutdown of a channel that is experiencing problems. Stop Queue Manager Performs an orderly shutdown of a queue manager that is experiencing problems. 116 IBM Tioli Monitoring for Business Integration: User s Guide

141 Table 13 contains a list of the MQSeries IBM Tioli Enterprise Console tasks that are aailable on each platform. Table 13. Platform support for MQSeries TEC tasks Task Distributed Proxy mode z/os Remote Start Queue Manager Stop Queue Manager Yes Yes No Ping Queue Manager Yes Yes Yes Display Queue Manager Yes Yes Yes Start Channel Stop Channel Yes Yes Yes Start Alternate Channel Yes Yes Yes Start Command Serer Yes Yes No Start Channel Initiator Yes Yes Yes Start Trigger Monitor Yes No No Start Channel Listener Yes Yes No Reset Channel Yes Yes Yes Start DLQ Handler Yes Yes No Stop DLQ Handler Yes Yes No Display Channel Attribute Yes Yes Yes IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer: The WICS Eent Console Tasks task library is installed during the installation process. The WICS Eent Console Tasks task library contains tasks for starting the resources used with an InterChange Serer. This task library includes the following tasks: Start_Adapter_Agent Starts an adapter agent. Start_Adapter_Controller Starts an adapter controller. Start_InterChange_Serer Starts a WebSphere InterChange Serer. Start_Collaboration Starts a collaboration. Start_SNMP_Agent Starts a WebSphere InterChange Serer SNMP agent. Table 14 contains a list of the tasks in the WICS Eent Console Tasks task library and the eents for which you can use each task. Table 14. Tioli Eent Console tasks and eents for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Task name Start_Adapter_Agent Eents for which to use the task WICS_Adapter_Agent_Stopped Chapter 6. Integrating with IBM Tioli Enterprise Console 117

142 Table 14. Tioli Eent Console tasks and eents for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer (continued) Task name Start_Adapter_Controller Eents for which to use the task WICS_Adapter_Controller_Stopped WICS_Adapter_Controller_Paused Start_Collaboration WICS_Collaboration_Stopped WICS_Collaboration_Paused Start_InterChange_Serer Start_SNMP_Agent WICS_InterChangeSerer_Down WICS_InterChangeSerer_Connection_Down Required authorization roles Refer to Appendix A, Authorization roles quick reference, on page 315. Before you begin Not applicable. When you finish Tasks executed from the IBM Tioli Enterprise Console might not return any information to Std Out for the status of the task. This problem occurs with tasks that exceed the one-minute timeout period een though the task does run. You can alidate that the task ran by checking for the *task*.log file in the $LCF_DATDIR/LCFNEW/CTQ/logs directory on the endpoint. Procedure 1. Right-click an eent and click Task Execution on the context menu. 2. Click the Task Libraries tab in the Task Execution window. 3. Expand either the MQSERIES TEC Tasks or the WICS Eent Console Tasks task library to display the tasks in the task library. 4. Click the task you want to run. 5. Click the Target Hosts tab and do the following: a. Moe the endpoint host name from the Current Hosts list to the Aailable Hosts list. b. Moe a managed node name from the Aailable Hosts list to the Current Hosts list. Additional information: For endpoints on distributed platforms, run a TEC task on any managed node. The TEC task subsequently runs on the endpoint. For proxy mode z/os endpoints, run a TEC task on the managed node on which the IBM Tioli Business Systems Manager task serer is installed. 6. Click the Task Libraries tab. 7. Click Execute Task. 118 IBM Tioli Monitoring for Business Integration: User s Guide

143 Chapter 7. Integrating with IBM Tioli Business Systems Manager The information in this chapter applies to the following IBM Tioli Monitoring for Business Integration components: IBM Tioli Monitoring for Business Integration: WebSphere MQ, not including Workflow Note: Support for IBM Tioli Business Systems Manager is not enabled for OS/400 operating systems. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Table 15 proides a list of the goals applicable to integrating IBM Tioli Monitoring for Business Integration software with IBM Tioli Business Systems Manager. The table also tells where to locate information about the procedures for each goal. Table 15. Integrating IBM Tioli Monitoring for Business Integration with IBM Tioli Business Systems Manager Goal Where to find procedures 1. Install the IBM Tioli Business Systems Manager integration software on the IBM Tioli Business Systems Manager serer. 2. Create the TBSM policy region. 3. Optionally, customize the line of business (LOB) iew so you can iew the relationship between the managed resources. 4. Discoer the WebSphere MQ or WebSphere MQ Integrator resources you want to manage on the Tioli Business Systems Manager console. 5. Configure a resource model to forward eents to IBM Tioli Business Systems Manager so you can monitor resources on the Tioli Business Systems Manager console. IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Integrating with IBM Tioli Business Systems Manager on page 121 Creating the WebSphere MQ task libraries for IBM Tioli Business Systems Manager on page 123 Customizing the Line of Business iew for WebSphere MQ resources on page 124 Discoering WebSphere MQ resources for IBM Tioli Business Systems Manager on page 126 Not applicable Not applicable Discoering WebSphere MQ Integrator resources for IBM Tioli Business Systems Manager on page 128 Customizing indications and eents on page 57 Copyright IBM Corp

144 Table 15. Integrating IBM Tioli Monitoring for Business Integration with IBM Tioli Business Systems Manager (continued) Goal 6. Naigate to the WebSphere MQ resources on the Tioli Business Systems Manager console. 7. Run tasks in the IBM Tioli Business Systems Managerconsole. Where to find procedures IBM Tioli Monitoring for Business Integration: WebSphere MQ Naigating to resources on page 129 IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Running tasks in the Tioli Business Systems Manager console on page Delete resources. Deleting resources on page Remoe integration with IBM Tioli Business Systems Manager. Uninstalling the integration with IBM Tioli Business Systems Manager on page 138 IBM Tioli Business Systems Manager oeriew You hae the option of managing resources on endpoints on distributed and proxy mode z/os systems from the Tioli Business Systems Manager console. IBM Tioli Business Systems Manager is a business systems management tool that enables you to graphically monitor and control interconnected business components and operating system resources. A business component and its resources are referred to as a Line of Business (LOB). IBM Tioli Business Systems Manager defines the concept of a business system to organize related applications. A business system includes all the applications that together perform a business function, such as WebSphere MQ processing. It also includes performance measures that determine whether the business system is functioning properly. For more information about IBM Tioli Business Systems Manager, refer to the IBM Tioli Business Systems Manager product documentation. Note: WebSphere MQ support for Tioli Business Systems Manager is not enabled for OS/400 operating systems. OS/400 is not supported for the Discoer tasks in the MQS Tioli Business Systems Manager task libraries. IBM Tioli Enterprise Console eents sent from resource models running on OS/400 endpoints discoer the OS/400 endpoint for IBM Tioli Business Systems Manager and create an icon. Howeer, the arious IBM Tioli Business Systems Manager tasks that can be run from IBM Tioli Business Systems Manager are not supported on OS/400. This chapter proides information about the following aspects of IBM Tioli Business Systems Manager: Using IBM Tioli Business Systems Manager to manage IBM Tioli Monitoring for Business Integration resources and eents IBM Tioli Monitoring for Business Integration tasks that you can run from IBM Tioli Business Systems Manager Uninstalling IBM Tioli Monitoring for Business Integration from IBM Tioli Business Systems Manager IBM Tioli Business Systems Manager consists of the following components: 120 IBM Tioli Monitoring for Business Integration: User s Guide

145 IBM Tioli Business Systems Manager management serer The IBM Tioli Business Systems Manager management serer processes all the aailability data that is collected from arious sources. Aailability data is inserted in the IBM Tioli Business Systems Manager database, where intelligent agents proide alerts on monitored objects and then broadcast those alerts to IBM Tioli Business Systems Manager workstations. The management serer processes all user requests that originate from workstations and includes a database serer that is built around a Microsoft SQL Serer database. IBM Tioli Business Systems Manager workstation A IBM Tioli Business Systems Manager workstation displays objects in customized iews, called Line of Business Views. Objects are presented in a hierarchical tree iew so that users can see the relationship between objects. Alerts are oerlaid on the objects when the aailability of the object is threatened. Tioli Business Systems Manager Eent Enablement Tioli Business Systems Manager Eent Enablement is installed on the IBM Tioli Enterprise Console eent serer and enables the eent serer to forward eents to IBM Tioli Business Systems Manager. Tioli Business Systems Manager Eent Enablement defines eent classes and rules for handling eents related to IBM Tioli Business Systems Manager. Task serer The IBM Tioli Business Systems Manager task serer is installed on the IBM Tioli Enterprise Console eent serer with Tioli Business Systems Manager Eent Enablement. It receies task requests from the IBM Tioli Business Systems Manager workstation, runs the tasks on the Tioli serer on which it is installed, and returns the output to IBM Tioli Business Systems Manager. Integrating with IBM Tioli Business Systems Manager Objectie To integrate IBM Tioli Monitoring for Business Integration: WebSphere MQ and IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator with IBM Tioli Business Systems Manager so you can receie WebSphere MQ and WebSphere MQ Integrator eents on IBM Tioli Business Systems Manager. Background information To enable IBM Tioli Business Systems Manager to manage WebSphere MQ or WebSphere MQ Integrator eents, you must run the integration program for IBM Tioli Monitoring for Business Integration: WebSphere MQ or IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator on the IBM Tioli Business Systems Manager serer. The integration programs perform the following steps for IBM Tioli Monitoring for Business Integration: WebSphere MQ and IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: Creates the object definitions that IBM Tioli Business Systems Manager uses to manage resources Imports icons for each object type Defines operational tasks for each object type Defines a line of business (LOB) for organizing resources Chapter 7. Integrating with IBM Tioli Business Systems Manager 121

146 When using the IBM Tioli Business Systems Manager, Version 1.5 product, the Tioli Business Systems Manager application serer is not stopped during product installation or during the uninstall process if the IBM Tioli Business Systems Manager serer and database reside on different machines. Additionally, when using the IBM Tioli Business Systems Manager, Version product, the uninstall process does not remoe the Line of Business (LOB) object from the GUI before running the IBM Tioli Monitoring for Business Integration: WebSphere MQ Tioli Business Systems Manager uninstall script. Before you begin the IBM Tioli Monitoring for Business Integration: WebSphere MQ Tioli Business Systems Manager integration script or the uninstall script for Version 1.5, you must stop the following serices: Tioli BSM Application Serer Tioli BSM Propagation Agent Dispatcher To completely uninstall the IBM Tioli Business Systems Manager, Version integration of IBM Tioli Monitoring for Business Integration: WebSphere MQ, you must first log on to the Tioli Business Systems Manager console and delete the WebSphere MQ LOB object from the GUI before running the uninstall script. Required authorization roles Administrator on the IBM Tioli Business Systems Manager serer Before you begin Install the Tioli Enterprise Console Adapter Configuration Facility. See the IBM Tioli Enterprise Console Installation Guide for more information. Make sure that your IBM Tioli Business Systems Manager enironment is configured correctly and that you hae Tioli Business Systems Manager Eent Enablement installed on each IBM Tioli Enterprise Console eent serer that you want to forward eents. For more information, see the IBM Tioli Business Systems Manager Installation and Configuration Guide. Before you integrate the software into IBM Tioli Business Systems Manager, perform the following prerequisite steps: Install the IBM Tioli Business Systems Manager configuration, as described in the IBM Tioli Business Systems Manager Installation and Configuration Guide. You must install IBM Tioli Business Systems Manager Version 1.5 with patch 35 or ersion Install and configure the Tioli Business Systems Manager Eent Enablement Version 1.5 or Version on all IBM Tioli Enterprise Console eent serers that receie eents that you want to forward to IBM Tioli Business Systems Manager. See the IBM Tioli Business Systems Manager Installation and Configuration Guide for more information. Install the IBM Tioli Enterprise Console Adapter Configuration Facility (ACF) on all gateways associated with the managed endpoints. See the IBM Tioli Enterprise Console Installation Guidefor information on installing the ACF. Configure IBM Tioli Business Systems Manager to communicate with each Tioli Business Systems Manager Eent Enablement installed in the preious step. See the IBM Tioli Business Systems Manager Installation and Configuration Guide for more information. 122 IBM Tioli Monitoring for Business Integration: User s Guide

147 When you finish Configure the eent serer if you hae not already done so. Configuring the eent serer is necessary for eents to be forwarded from the eent serer to IBM Tioli Business Systems Manager. See Configuring the eent serer on page 95. If you hae not already done so, create a Tioli object for each queue manager you want to manage as described in Populating the management domains on page 176. Procedure 1. On the Tioli Business Systems Manager serer, insert the component software CD for the software you are using: IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Component Software. 2. Naigate to the \TBSM directory. 3. At a command prompt, type install to start the installation wizard and open the welcome screen. 4. Click Next. 5. Accept the default installation location (C:\tioli\wmq or C:\tioli\wmqi) or click Browse to specify a different installation location. 6. Click Next to continue. 7. Enter the Microsoft SQL serer information as follows: SQL Serer Name of the SQL serer that is associated with the Tioli Business Systems Manager serer SQL Userid SQL user ID SQL Password Password for the specified SQL user ID 8. Click Next to start the installation. A progress bar is displayed to show the progress of the installation, and a message is displayed when the installation is complete. 9. Click Finish to exit the installation wizard. Creating the WebSphere MQ task libraries for IBM Tioli Business Systems Manager Objectie To create the task libraries that contain the IBM Tioli Monitoring for Business Integration: WebSphere MQ tasks that you can run from the Tioli Business Systems Manager console. Background information For a description of the WebSphere MQ integration with Tioli Business Systems Manager tasks, see Running tasks in the Tioli Business Systems Manager console on page 130. Chapter 7. Integrating with IBM Tioli Business Systems Manager 123

148 Required authorization roles MQS_senior super Before you begin Install WebSphere MQ support for Tioli Business Systems Manager as described in Integrating with IBM Tioli Business Systems Manager on page 121. Install the Tioli Enterprise Console Adapter Configuration Facility. When you finish The MQS Create TBSM Policy Region job creates the MQS TBSM Instrumentation policy region within the Monitoring for WebSphere MQ policy region, and it creates the following task libraries within the MQS TBSM Instrumentation policy region: MQS TBSM QMgr Tasks MQS TBSM Queue Tasks MQS TBSM Channel Tasks Procedure 1. Open the Monitoring for WebSphere MQ policy region. 2. Open the MQS Utility Tasks task library. 3. Run the MQS Create TBSM Policy Region job. Customizing the Line of Business iew for WebSphere MQ resources Objectie To customize the Line of Business iew so you can iew the relationship between a queue manager and its queues and channels. Background information IBM Tioli Monitoring for Business Integration: WebSphere MQ proides a script, mqs_config_lob, to enable you to customize the All Lines of Business Container iew so that you can iew the relationship between each queue manager and its queues and channels. The mqs_config_lob script creates an LOB for each queue manager that you specify. Each queue manager LOB contains the following: A queue manager instance for each discoered queue manager, which can be used for monitoring health or running tasks A top-leel channel LOB, which contains LOBs for each type of channel: client connection, serer connection, receier, requester, sender, serer, cluster sender, and cluster receier. These LOBs contain the channel resources that hae been discoered and that belong to the queue manager. A top-leel queue LOB, which contains LOBs for each type of queue: local, remote, model, and alias. These LOBs contain the queue resources that hae been discoered and that belong to the queue manager. Because IBM Tioli Business Systems Manager inserts WebSphere MQ resources into the LOBs only when the resources are initially discoered, you must run the mqs_config_lob script prior to discoering your WebSphere MQ resources as described in Discoering WebSphere MQ resources for IBM Tioli Business Systems Manager on page IBM Tioli Monitoring for Business Integration: User s Guide

149 You can use the mqs_config_lob sample script as proided. If the result does not entirely meet your needs, you might find it useful to modify the sample script to achiee the result you want. The mqs_config_lob script is located in the \TBSM directory on the IBM Tioli Monitoring for Business Integration, Version 5.x: WebSphere MQ Component Software CD. The syntax for the mqs_config_lob script is: mqs_config_lob q qmgr_file [ c] [ l logfile] [ U userid] [ P password] [ S serer] [ ] q qmgr_file Specifies the name of the file that contains the list of queue managers for which to create lines of business (LOBs). The format of the file is a list of queue managers with each queue manager name (queue_manager_name@host_name) on a separate line. c Cleans up any existing filters on existing queue manager LOBs. This option is useful if you are creating LOBs for a queue manager for which LOBs hae already been created. Using this option aoids adding redundant filter criteria. l logfile Specifies the file in which to log the output from the mqs_config_lob script. The default log file is./mqs_config_lob.log. U userid Specifies the SQL user ID to the SQL serer machine. P password Specifies the SQL password for the specified SQL user ID. S serer Specifies the host name of the SQL serer machine. Runs the mqs_config_lob in erbose mode. Note: You can set the S, U, and P parameters as enironment ariables instead of specifying these parameters on the command line. To do this, set the tbsm_serer, tbsm_userid, and tbsm_password enironment ariables from a korn shell window with the following sequence of commands: export tbsm_serer=sql_serer_hostname export tbsm_userid=sql_userid export tbsm_password=sql_password where: sql_serer_hostname Is the host name of the SQL serer machine sql_userid Is the SQL user ID to the SQL serer machine sql_password Is the SQL password for the specified SQL user ID Required authorization roles Not applicable. Before you begin Install WebSphere MQ support for Tioli Business Systems Manager as described in Integrating with IBM Tioli Business Systems Manager on page 121. Chapter 7. Integrating with IBM Tioli Business Systems Manager 125

150 Additional Information: Before you use the mqs_config_lob script, consider that the mqs_config_lob script creates 15 LOBs (RON COUNTS 13.) for each queue manager you specify. Therefore, the mqs_config_lob script can create a ery large number of LOBs. For example, if you run the mqs_config_lob script with a queue manager file that contains the names of 1000 queue managers, the mqs_config_lob script creates 15,000 LOBs. When you finish Discoer the WebSphere MQ resources you want to manage on the Tioli Business Systems Manager console as described in Discoering WebSphere MQ resources for IBM Tioli Business Systems Manager. Procedure 1. Create the list of queue managers for which you want to create LOBs by following these steps: a. Enter the following command on any managed node: wlookup r MQM_QMgr al > qmgr_file Where qmgr_file is the file name in which to write the list of queue managers. b. Modify the qmgr_file to add or delete queue managers names as appropriate. c. Copy the qmgr_file to the IBM Tioli Business Systems Manager serer. 2. Enter the following command from a korn shell window on the IBM Tioli Business Systems Manager serer: mqs_config_lob q qmgr_file Discoering WebSphere MQ resources for IBM Tioli Business Systems Manager Objectie To discoer the WebSphere MQ resources that you want to manage on the Tioli Business Systems Manager console. Background information The IBM Tioli Monitoring for Business Integration: WebSphere MQ support that you installed in Integrating with IBM Tioli Business Systems Manager on page 121 defined the types of objects that you want IBM Tioli Business Systems Manager to manage. Required authorization roles MQS_senior admin Before you begin 1. Install the WebSphere MQ support for Tioli Business Systems Manager as described in Integrating with IBM Tioli Business Systems Manager on page Create the WebSphere MQ support for Tioli Business Systems Manager task libraries as described in Creating the WebSphere MQ task libraries for IBM Tioli Business Systems Manager on page 123. When you finish Not applicable. 126 IBM Tioli Monitoring for Business Integration: User s Guide

151 Procedure To discoer the WebSphere MQ resources you want to manage on the Tioli Business Systems Manager console, run the following discoery tasks in the MQS TBSM Instrumentation policy region within the Monitoring for WebSphere MQ policy region on the desktop: Discoer_Queue_Managers task located in the MQS TBSM QMgr Tasks task library Run the Discoer_Queue_Managers task against the queue manager objects you want to manage on the Tioli Business Systems Manager console. The queue managers are discoered whether their status is up or down. Discoer_Queues task located in the MQS TBSM Queue Tasks task library Run the Discoer_Queues task against the queue manager objects for the queues you want to manage. The queues are discoered only when the queue managers are running. To control the queues that are discoered, you can enter a queue name and a queue type. You can specify a queue name that ends with an asterisk (*), which matches all queue names beginning with the specified characters followed by zero or more characters, or you can specify only an asterisk (*), which matches all queue names. The queue name must conform to the WebSphere MQ object naming conentions. The queue type must be a alid WebSphere MQ queue type or the keyword ALL. Discoer_Channels task located in the MQS TBSM Channel Tasks task library Run the Discoer_Channels task against the queue manager objects for the channels you want to manage. The channels are discoered only when the queue managers are running regardless of the status of the channels. To control the channels that are discoered, you can enter a channel name and a channel type. You can specify a channel name that ends with an asterisk (*), which matches all channel names beginning with the specified characters followed by zero or more characters, or you can specify only an asterisk (*), which matches all channel names. The channel name must conform to the WebSphere MQ object naming conentions. The channel type must be a alid WebSphere MQ channel type or the keyword ALL. You can run the discoery tasks immediately, or you can schedule the discoery tasks to run one or more times later. If you want to schedule a discoery task, create a job from the discoery task, and drag the discoery job onto the Scheduler icon on the desktop. For more information about creating a job, see Creating a job on page 158. To discoer WebSphere MQ resources on proxy mode z/os systems, a NETCONV connection must exist between proxy mode z/os and the focal point NetView. For more information, see IBM Tioli Monitoring for Business Integration: WebSphere MQ for proxy mode z/os on page 17. When a WebSphere MQ resource is discoered, a discoery eent (MQS_TBSM_HEARTBEAT) is sent to the eent serer. The eent serer forwards the discoery eent to the Tioli Business Systems Manager serer, and an icon is displayed on the Tioli Business Systems Manager console. The icon is labeled as follows: Component;5.x:InstanceID@hostname where: Component Is one of the following: WMQ_Qmgr for a queue manager icon Chapter 7. Integrating with IBM Tioli Business Systems Manager 127

152 WMQ_Queue for a queue icon WMQ_Channel for a channel icon InstanceID Is the name of the queue manager, queue, or channel in the following formats: For a queue manager: queue_manager_name@hostname For a queue: queue_name@queue_manager_name@hostname For a channel: channel_name@queue_manager_name@hostname Where hostname is the host name of the computer on which the queue manager resides. For SNA, hostname is the NetView domain name. For a remotely administered queue manager, hostname is the host name of the source queue manager. hostname Is the fully qualified host name of the machine on which the discoery task runs as follows: For distributed systems, the host name of the endpoint where the queue manager reside For proxy mode z/os, the host name of the machine running the task serer For a remotely administered queue manager, the host name of the source queue manager Discoering WebSphere MQ Integrator resources for IBM Tioli Business Systems Manager Objectie To define the specific IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects to IBM Tioli Business Systems Manager Background information The IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator support that you installed in Integrating with IBM Tioli Business Systems Manager on page 121 defined the types of objects that you want IBM Tioli Business Systems Manager to manage. After you define the object types, you must define the specific objects. You can do this with the MQSI TBSM Discoery Eents task. This task searches a managed node for objects and sends a DISCOVER eent to IBM Tioli Business Systems Manager for each object. The MQSI TBSM Discoer task also maintains a list of the objects that hae been discoered and alerts IBM Tioli Business Systems Manager when they hae been deleted by sending IBM Tioli Business Systems Manager a GONE eent for each object that no longer exists on the managed node. Required authorization role mqsi_user Before you begin Configure your IBM Tioli Enterprise Console eent serer, as described in Configuring the eent serer on page 95. When you finish Use IBM Tioli Business Systems Manager to iew and manage your WebSphere MQ Integrator objects. For information on using IBM Tioli Business Systems 128 IBM Tioli Monitoring for Business Integration: User s Guide

153 Manager, see the IBM Tioli Business Systems Manager User s Guide. For information about the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator tasks that you can run from IBM Tioli Business Systems Manager, see Running tasks in the Tioli Business Systems Manager console on page 130. Procedure You can perform this procedure from the Tioli desktop. Desktop: Naigating to resources Use the following steps to run this procedure as a task: 1. In the Utility Tasks task library, double-click the MQSI TBSM Discoer task. 2. Select the managed node on which you want to search for objects and click Execute. If the task completes successfully, you receie a list of the DISCOVER and GONE eents that were sent to IBM Tioli Business Systems Manager. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator also proides a job, MQSI TBSM Discoer, to run this procedure. For information about running jobs, see Running a job on page 162. Objectie To naigate to resources on the Tioli Business Systems Manager console. Background information You can iew resources in IBM Tioli Business Systems Manager in the following ways: Tree iew displays objects in a hierarchical tree format. This is the default iew. Hyper iew displays objects in an elliptical iew from the launch point of the selected object. Managed object iew displays objects in list or column format that has sorting capabilities. Business impact iew displays objects in a combination pictorial and list iew. Required authorization roles Not applicable. Before you begin 1. Install the WebSphere MQ or WebSphere MQ Integrator support for IBM Tioli Business Systems Manager as described in Integrating with IBM Tioli Business Systems Manager on page Create the WebSphere MQ support with IBM Tioli Business Systems Manager task libraries as described in Creating the WebSphere MQ task libraries for IBM Tioli Business Systems Manager on page Discoer the WebSphere MQ resources you want to manage on the Tioli Business Systems Manager console as described in Discoering WebSphere MQ resources for IBM Tioli Business Systems Manager on page 126. When you finish Not applicable. Procedure To locate a specific resource in the tree iew, follow these steps: 1. Open the Tioli Business Systems Manager console. Chapter 7. Integrating with IBM Tioli Business Systems Manager 129

154 2. Expand the Business Object Container icon or the All Lines of Business Container icon and locate the resource icon as follows: In the Business Object Container: BUSC iew, the default placement of the icon for a resource depends on the TCP/IP host name of the business component that forwards the eent. In the All Lines of Business Container iew, the default placement of the icon appears in the Line of Business: under the IBM LOB. You can iew additional information using the Hyper View, Managed Object View, and Business Impact View. 3. Double-click the resource to obtain the object detail property, such as current eents, object attributes, or alerts. For more information, refer to the IBM Tioli Business Systems Manager product documentation. Running tasks in the Tioli Business Systems Manager console Objectie To run tasks for WebSphere MQ support for Tioli Business Systems Manager (except for discoery tasks) and WebSphere MQ integration support for Tioli Business Systems Manager from the Tioli Business Systems Manager console. Background information In addition to using IBM Tioli Business Systems Manager to monitor the state of your resources, you can also run tasks on the objects. WebSphere MQ support for Tioli Business Systems Manager: With the exception of the discoery tasks, you can run WebSphere MQ support for IBM Tioli Business Systems Manager tasks from the Tioli Business Systems Manager console. You can run the discoery tasks only from the Tioli Desktop. The MQS TBSM Instrumentation policy region located in the Monitoring for WebSphere MQ policy region on the desktop contains the WebSphere MQ support for IBM Tioli Business Systems Manager tasks. The user ID that starts the task serer must hae the appropriate Tioli authorization roles to run a WebSphere MQ support for Business Systems Manager task. Note: When running a task using the IBM Tioli Monitoring for Business Integration WebSphere MQ - TBSM Integration product from IBM Tioli Business Systems Manager, Version 2.1 or console, an inalid login will occur if you log in under the following condition: Your Tioli management region serer login ID and password are different from your IBM Tioli Enterprise Console serer login ID and password. Download and install the following IBM Tioli Business Systems Manager patches to correct this problem: IBM Tioli Business Systems Manager, Version 2.1, 2.1-BSM-0002-E14 IBM Tioli Business Systems Manager, Version 2.1.1, BSM-0002-E23 When running the odadmin command from the IBM Tioli Enterprise Console eent serer, ensure that Remote client login allowed = TRUE. Run the following command if Remote client login allowed is not set to TRUE: 130 IBM Tioli Monitoring for Business Integration: User s Guide

155 odadmin set_allow_rconnect TRUE Table 16, Table 17 on page 134, and Table 18 on page 135 contain descriptions of the tasks that you can run for queue managers, queues, and channels. The tables also contain the parameters for each task and the required authorization role. Queue Manager tasks: Table 16 describes the WebSphere MQ support for IBM Tioli Business Systems Manager queue manager tasks. The MQS TBSM Queue Manager Tasks task library in the MQS TBSM Instrumentation policy region within the Monitoring for WebSphere MQ policy region on the desktop contains the queue manager tasks. These queue manager tasks are aailable on the Tioli Business Systems Manager console from the Operational Tasks option on the queue manager icon context menu. Table 16. WebSphere MQ support with IBM Tioli Business Systems Manager Manager queue manager tasks Task Description Required authorization role Discoer_Queue_Managers¹ Discoers queue managers and creates icons for the discoered queue managers on the Tioli Business Systems Manager console. MQS_senior and admin Display_Attributes Parameters: None. Displays the attributes of the queue manager. Parameters: None. MQS_user and admin Display_Cluster_Queue_Manager Display_Error_Log Display_Queue_Names Display_Status_of_All_Channels Display_Status_of_All_Queue Managers Ping Displays information about queue managers in a cluster. Parameters: None. Displays the last 100 lines of the queue manager WebSphere MQ error log. This task is not supported on proxy mode z/os or on remote queue managers. Parameters: None. Displays the names of all queues defined to the queue manager. Parameters: None. Displays the status (up or down) of all channels. Parameters: None. Displays the status (up or down) of all queue managers. Parameters: None. Pings a queue manager to determine if it is responsie to commands. Parameters: None. MQS_user and admin MQS_user and admin MQS_user and admin MQS_user and admin MQS_user and admin MQS_user and admin Chapter 7. Integrating with IBM Tioli Business Systems Manager 131

156 Table 16. WebSphere MQ support with IBM Tioli Business Systems Manager Manager queue manager tasks (continued) Task Description Required authorization role Refresh_Cluster Discards all locally-held cluster information (including any automatically defined channels that are in doubt) and forces the information to be rebuilt. This enables the cluster to be cold-started. Parameters: MQS_senior and admin Reset_Cluster Resume_Queue_Manager Start² Stop_Controlled² Stop_Immediate² Cluster Name Specifies the name of the cluster for which locally held information should be remoed and rebuilt. Performs special operations on clusters. For more information about forcibly remoing a queue manager from a cluster, refer to the WebSphere MQ product documentation. Parameters: Cluster Name Specifies the name of the cluster from which the queue manager should be remoed. Queue Manager Name Specifies the name of the queue manager to be remoed from the cluster. Informs other queue managers in a cluster that the local queue manager is aailable again for processing and can be sent messages. This task reerses the Suspend_Queue_Manager task s action. Parameters: Enter one of the following: Cluster Name Specifies the name of the cluster to which the queue manager should be reinstated after haing been suspended. Name List Specifies the name of the list of clusters to which the queue manager should be reinstated after haing been suspended. If both a cluster name and a name list is proided, this task uses the Name List. Starts a queue manager. Parameters: None. Stops a queue manager with the QUIESCE option, allowing programs that are currently running to finish processing. Parameters: None. Stops a queue manager immediately. This action might cause in-doubt situations. Parameters: None. MQS_senior and admin MQS_admin and admin MQS_admin and admin MQS_admin and admin MQS_admin and admin 132 IBM Tioli Monitoring for Business Integration: User s Guide

157 Table 16. WebSphere MQ support with IBM Tioli Business Systems Manager Manager queue manager tasks (continued) Task Description Required authorization role Start_TEC_Adapter² Starts the WebSphere MQ eent adapter. MQS_admin and admin Stop_TEC_Adapter² Suspend_Queue_Manager Parameters: None. Stops the WebSphere MQ eent adapter. Parameters: None. Informs other queue managers in a cluster that the local queue manager is not aailable for processing and cannot be sent messages. Use the Resume_Queue_Manager task to reerse this action. Parameters: Enter one of the following: Cluster Name Specifies the name of the cluster from which the queue manager should be made unaailable. MQS_admin and admin MQS_admin and admin Name List Specifies the name of the list of clusters from which the queue manager should be made unaailable. If both a cluster name and a name list is proided, this task uses the Name List. ¹The Discoer_Queue_Managers task is aailable only from the MQS TBSM QMgr Tasks task library on the desktop. ²The Start, Stop_Controlled, Stop_Immediate, Start_TEC_Adapter, and Stop_TEC_Adapter tasks cannot be run on remotely administered queue managers. Queue tasks: Table 17 on page 134 describes the WebSphere MQ support for IBM Tioli Business Systems Manager queue tasks. The MQS TBSM Queue Tasks task library in the MQS TBSM Instrumentation policy region within the Monitoring for WebSphere MQ policy region on the desktop contains the queue tasks. These queue tasks are aailable on the Tioli Business Systems Manager console from the Operational Tasks option on a queue icon context menu. Chapter 7. Integrating with IBM Tioli Business Systems Manager 133

158 Table 17. WebSphere MQ support for Tioli Business Systems Manager queue tasks Task Description Required authorization role Discoer_Queues¹ Discoers queues and creates icons for the discoered queues on the Tioli Business Systems Manager console. Parameters: Name Filter Specifies the name of the queues to be discoered. This name can include pattern-matching characters that follow WebSphere MQ conentions. IBM Tioli Monitoring for Business Integration: WebSphere MQ discoers only the queues that match this name. MQS_senior and admin Clear_Local_Queue Display_Attributes Display_Local_Messages² Select a Queue Type Specifies the type of queues to be discoered. IBM Tioli Monitoring for Business Integration: WebSphere MQ discoers only the queues of the specified type. Clears the local WebSphere MQ queue. Parameters: None. Displays the attributes of a queue. Parameters: None. Displays local messages. MQS_senior and admin MQS_user and admin MQS_user and admin Parameters: None. ¹The Discoer_Queue task is aailable only from the MQS TBSM Queue Tasks task library on the desktop. ²The Display_Local_Messages task runs only on distributed platforms. Channel tasks: Table 18 on page 135 describes the WebSphere MQ support for IBM Tioli Business Systems Manager channel tasks. The MQS TBSM Channel Tasks task library in the MQS TBSM Instrumentation policy region within the Monitoring for WebSphere MQ policy region on the desktop contains the channel tasks. These channel tasks are aailable on the Tioli Business Systems Manager console from the Operational Tasks option on a channel icon context menu. 134 IBM Tioli Monitoring for Business Integration: User s Guide

159 Table 18. WebSphere MQ support for Tioli Business Systems Manager channel tasks Task Description Required authorization role Discoer_Channels¹ Discoers channels and creates icons for the discoered channels on the Tioli Business Systems Manager console. Parameters: Name Filter Specifies the name of the channels to be discoered. This name can include pattern-matching characters that follow WebSphere MQ conentions. IBM Tioli Monitoring for Business Integration: WebSphere MQ discoers only the channels that match this name. MQS_senior and admin Display_Attributes Display_Current_Status Ping Reset Resole_Indoubt_backout Resole_Indoubt_commit Start Stop Select a Channel Type Specifies the type of channels to be discoered. IBM Tioli Monitoring for Business Integration: WebSphere MQ discoers only the channels of the specified type. Displays the attributes of a channel. Parameters: None. Displays additional information, such as, the number of messages that are sent and receied. Parameters: None. Pings a channel to determine if it is responsie to commands. Parameters: None. Resets the message sequence number for a WebSphere MQ channel. Parameters: None. Resoles channels that were left in-doubt because they were not resoled automatically. The threads are backed out. Parameters: None. Resoles channels that were left in-doubt because they were not resoled automatically. The threads are committed. Parameters: None. Starts a channel. Parameters: None. Stops a channel. MQS_user and admin MQS_user and admin MQS_user and admin MQS_admin and admin MQS_admin and admin MQS_admin and admin MQS_admin and admin MQS_admin and admin Parameters: None. ¹The Discoer_Channels task is aailable only from the MQS TBSM Channel Tasks task library on the desktop. Chapter 7. Integrating with IBM Tioli Business Systems Manager 135

160 WebSphere MQ integration support for Tioli Business Systems Manager: The following WebSphere MQ Integrator objects are created in IBM Tioli Business Systems Manager: MQSIBroker MQSIConfigMgr MQSIUsrNameSr Table 19 and Table 20 contain descriptions of the tasks that you can run for brokers, Configuration Managers, and User Name Serers. The tables also contain the parameters for each task and the required authorization role. Operational tasks for all objects: Table 19 contains descriptions and authorization roles for each operational task. Table 19. WebSphere MQ integration support for Tioli Business Systems Manager operational tasks for all objects Task Description Required authorization role Start_Component Stop_Component Component_Properties Starts a broker, Configuration Manager, or User Name Serer component by inoking the mqsistart command. Stops a broker, Configuration Manager, or User Name Serer component by inoking the mqsistop command. Displays the configuration settings for a component. mqsi_admin mqsi_admin mqsi_user Component_Status Checks the current status of a component. mqsi_user Broker tasks: task. Table 20 contains descriptions and authorization roles for each broker Table 20. WebSphere MQ integration support for Tioli Business Systems Manager broker tasks Task Description Required authorization role Start_Stop_All_MessageFlow Starts or stops the message flows in a broker. mqsi_admin Start_MQSI_Eent_Adapter Starts the MQSI eent adapter. mqsi_admin Stop_MQSI_Eent_Adapter Stops the MQSI Eent Adapter. mqsi_admin All broker objects hae MQSIBroker identified as the software component and 2.x as the ersion. Configuration Manager tasks: The Configuration Manager object has MQSIConfigMgr identified as the software component and 2.x as the ersion User Name Serer tasks: The User Name Serer object has the MQSIUsrNameSr identified as the software component and 2.x as the ersion See the IBM Tioli Monitoring for Business Integration Problem Determination Guide for troubleshooting information. Required authorization role See Table 16 on page 131, Table 17 on page 134, and Table 18 on page 135 for the authorization roles for each WebSphere MQ task. Before you begin Not applicable. 136 IBM Tioli Monitoring for Business Integration: User s Guide

161 Deleting resources When you finish Not applicable. Procedure IBM Tioli Monitoring for Business Integration: WebSphere MQ: 1. Double-click the target Line of Business. 2. Right-click a queue manager, channel, or queue icon. 3. Click Operational Tasks from the icon context menu. 4. Click the task that you want to run. 5. Complete the parameters, if any, using the information in Table 16 on page 131, Table 17 on page 134, and Table 18 on page 135. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator: 1. Double-click the target Line of Business. 2. Right-click a broker, User Name serer, or Configuration Manager icon. 3. Click Operational Tasks from the icon context menu. 4. Click the task that you want to run. 5. Complete the parameters, if any, using the information in Table 19 on page 136 and Table 20 on page 136. Objectie To delete objects from IBM Tioli Business Systems Manager. Background information You can delete the queue manager, channel, or queue object objects in IBM Tioli Monitoring for Business Integration: WebSphere MQ. You can delete the MQSIBroker, MQSIConfigMgr, or MQSIUsrNameSr objects in IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. When an object is deleted with an IBM Tioli Monitoring for Business Integration: WebSphere MQ task or an IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator task, a GONE eent is generated for the object. The GONE eent is forwarded to IBM Tioli Business Systems Manager, and IBM Tioli Business Systems Manager deletes the object. Required authorization role mqsi_user OR MQS_senior Before you begin Not applicable. When you finish The resource is deleted from the IBM Tioli Business Systems Manager console and marked as deleted in the WebSphere Integrator line of business Procedure For information about running a task from a task library, see Task library on page 145. Chapter 7. Integrating with IBM Tioli Business Systems Manager 137

162 For more information about specific tasks, see the following: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide Delete Queue Manager Delete Queue Delete Channel IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide Delete Broker Delete Configuration Manager Delete User Name Serer Uninstalling the integration with IBM Tioli Business Systems Manager Objectie To remoe the WebSphere MQ support for IBM Tioli Business Systems Manager WebSphere MQ integration support for Tioli Business Systems Manager software or the WebSphere MQ integration support for Tioli Business Systems Manager software from IBM Tioli Business Systems Manager. Background information Uninstalling the support for IBM Tioli Business Systems Manager software remoes the WebSphere MQ or WebSphere MQ Integrator object definitions and objects from IBM Tioli Business Systems Manager. When using the IBM Tioli Business Systems Manager, Version 1.5 product, the application serice is not stopped during product installation or during the uninstall process if the IBM Tioli Business Systems Manager serer and database reside on different machines. Additionally, when using the IBM Tioli Business Systems Manager, Version product, the uninstall process does not remoe the Line of Business (LOB) object from the GUI before running the IBM Tioli Monitoring for Business Integration: WebSphere MQ Tioli Business Systems Manager uninstall script. Before you begin the IBM Tioli Monitoring for Business Integration: WebSphere MQ Tioli Business Systems Manager integration script or the uninstall script for Version 1.5, you must stop the following serices: Tioli BSM Application Serer Tioli BSM Propagation Agent Dispatcher To completely uninstall the IBM Tioli Business Systems Manager, Version integration of IBM Tioli Monitoring for Business Integration: WebSphere MQ, you must first log on to the Tioli Business Systems Manager console and delete the WebSphere MQ LOB object from the GUI before running the uninstall script. Required authorization roles Administrator Before you begin When using the IBM Tioli Business Systems Manager, Version 1.5 product, the application serice is not stopped during product installation or during the uninstall process if the IBM Tioli Business Systems Manager serer and database reside on different machines. Additionally, when using the IBM Tioli Business Systems Manager, Version product, the uninstall process does not remoe the Line of Business (LOB) object from the GUI before running the IBM Tioli Monitoring for Business Integration: WebSphere MQ Tioli Business Systems Manager uninstall script. Before you begin the IBM Tioli Monitoring for Business 138 IBM Tioli Monitoring for Business Integration: User s Guide

163 Integration: WebSphere MQ Tioli Business Systems Manager integration script or the uninstall script for Version 1.5, you must stop the following serices: Tioli BSM Application Serer Tioli BSM Propagation Agent Dispatcher To completely uninstall the IBM Tioli Business Systems Manager, Version integration of IBM Tioli Monitoring for Business Integration: WebSphere MQ, you must first log on to the Tioli Business Systems Manager console and delete the WebSphere MQ LOB object from the GUI before running the uninstall script. When you finish Not applicable. Procedure 1. On the Tioli Business Systems Manager serer, naigate to the directory in which you installed the integration with IBM Tioli Business Systems Manager software. The default installation directory is C:\tioli\wmq or C:\tioli\wmqi. 2. Enter uninstall to start the uninstallation wizard and open the welcome screen. 3. Click Next to open the installation location for the integration with IBM Tioli Business Systems Manager software. 4. Click Next to continue. 5. Enter the Microsoft SQL Serer information as follows: SQL Serer Name of the SQL serer that is associated with this Tioli Business Systems Manager serer SQL Userid SQL user ID SQL Password Password for the specified SQL user ID Click Next to start the uninstallation. 6. Click Finish to exit the uninstallation wizard. Chapter 7. Integrating with IBM Tioli Business Systems Manager 139

164 140 IBM Tioli Monitoring for Business Integration: User s Guide

165 Chapter 8. Working with tasks and jobs The information in this chapter applies to the following IBM Tioli Monitoring for Business Integration components: IBM Tioli Monitoring for Business Integration: WebSphere MQ, not including Workflow IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Table 21 shows the goals for managing tasks and jobs and where to find the procedures. Table 21. Working with tasks and jobs Goal Where to find procedures 1. Enable remote administration to run WebSphere MQ commands on queue Enabling remote administration for WebSphere MQ on page 142 managers that do not reside on Tioli endpoints. 2. Run a task to perform a specific operation. Running a task on page Change the timeout alue for an icon context menu task. 4. Define a standard task with specific arguments to customize the task. Changing the timeout alue for a WebSphere MQ icon context menu task on page 154 Customizing a task on page Create a job from a task so that it can be Creating a job on page 158 scheduled to run. 6. Run a job with predefined arguments. Running a job on page Schedule jobs to run at specified times. Scheduling a job on page 163 Tasks and jobs oeriew A task is an action that can be routinely performed on selected managed resources throughout the network. A task defines the executables to be run, the authorization role required to execute the task, and the user or group name under which the task executes. The product proides standard tasks in task libraries. Standard tasks run on any machine without consideration of platform type. A customized task is a standard task with defined arguments saed in the task library with a unique name. For example, you can customize a task to sae task output results to a file after each execution. Because you can customize task arguments, the Tioli enironment does not open argument windows when you run the task from the desktop. Howeer, if you run a customized task from the command line, you still must specify the task arguments. Running a customized task requires additional information before it runs, such as the target of the execution. A job is a task with defined and saed arguments that can be executed many times on specific managed resources. You can create jobs from both standard and customized tasks in the product task library. Like tasks, you store jobs in task Copyright IBM Corp

166 libraries so you can reuse them. After you create a job, you can run it immediately using the procedure described in Running a job on page 162. You also can schedule jobs to run at certain times in the Scheduler, as described in Scheduling a job on page 163. Note: The following characters used in a text field in a task window cause errors: (single-quote) \ (backslash) as the last character in a text string that contains spaces ( (left parenthesis) ) (right parenthesis) (double-quote) These characters also cause errors when used in an attribute field in a task window. These errors occur when you run a task from an icon context menu or from the Queue Manager Control Center, and one of the attributes in the task dialog contains one or more of the specified characters. Do not use these characters in a text field, such as the Description field in a task window. Howeer, you can use the single-quote ( ) if you enclose an entire string inside a pair of single quotes, for example, my queue manager description. If the WebSphere MQ attribute includes a \ (backslash), ( (left parenthesis) or ) (right parenthesis), run the task from the appropriate task library. Enabling remote administration for WebSphere MQ Objectie To enable remote administration. Background information The remote administration facility enables you to run WebSphere MQ commands on queue managers that do not reside on Tioli endpoints. In this way, the remote administration facility enables you to extend your administration of WebSphere MQ resources to your entire network. For example, you can manage a queue manager that resides on a node running VSE/VSA. The remote administration facility is supported on distributed systems only. Required authorization roles MQS_senior or MQS_domain_name_senior admin Before you begin Not applicable. When you finish You must define the irtual ID ($tmemqs_user) and the irtual group ($tmemqs_group) on the machine where the target queue manager resides. You must define the $tmemqs_user and $tmemqs_group irtual ID and group as it is defined on the machine where the source queue manager resides. For more information about the irtual ID and group, see Changing the mapping of the irtual user ID for WebSphere MQ on page IBM Tioli Monitoring for Business Integration: User s Guide

167 Running a task Procedure To enable remote administration, follow these steps: 1. Create a queue manager object (icon) for each remote queue manager that you want to manage. Follow these steps: a. From the Monitoring for WebSphere MQ policy region, right-click the appropriate management domain icon and click Create Queue Manager Icon on the icon context menu. The Create Queue Manager Icon window opens. b. Complete the fields, referring to the online help if you need additional information. c. Click Set and Execute. 2. Define the channels and queues between the queue manager on which you run the IBM Tioli Monitoring for Business Integration: WebSphere MQ task and the queue manager on which you want to run the WebSphere MQ command. For information about preparing channels and queues for remote administration, refer to the WebSphere MQ product documentation. Additional Information: The Create Queue Manager Icon task creates a queue manager object in the Tioli database, and it creates a queue manager icon on the desktop. The icon label is qmgrname@hostname, where qmgrname is the name of the queue manager on which the WebSphere MQ command is to run, and hostname is the host name for the queue manager on which the IBM Tioli Monitoring for Business Integration: WebSphere MQ tasks are run (where the source queue manager exists). The icon has an icon context menu that enables you to perform common tasks. Objectie A task is an action that can be routinely performed on selected managed nodes and endpoints throughout the network. A task defines the executables to be run, the authorization role required to execute the task, and the user or group name under which the task will execute. The product proides standard tasks in task libraries. Standard tasks run on any machine without consideration of platform type. Background information For an understanding of tasks, see the introduction in this chapter. You can initiate tasks in a ariety of ways: From a task library From an icon with a context menu From a window menu bar IBM Tioli Monitoring for Business Integration: WebSphere MQ - Queue Manager Control Center - Information Center - Workflow Serices Window IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator - Execution Groups - Message Flows IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer - Adapter Controller Chapter 8. Working with tasks and jobs 143

168 - Collaborations - Profile - ICS logs All IBM Tioli Monitoring software - Tioli log Most tasks proided in the task libraries are aailable from the icon context menus for policy regions and from the icons for resources. In IBM Tioli Monitoring for Business Integration: WebSphere MQ, most tasks are also aailable from the management domain. For all IBM Tioli Monitoring for Business Integration components, running a task from an icon context menu has the adantage of proiding quick access to the task. This eliminates the need to naigate to the appropriate task library to run the task. Running tasks from an icon or a window makes it easier for you to manage resources in the following ways: The name of the resource is automatically filled in on the task window. When you double-click a resource, the window for changing the resource contains the current settings for the selected resource. You can change the appropriate settings and accept the settings you want to keep. In addition to proiding quick access to IBM Tioli Monitoring for Business Integration: WebSphere MQ, running a task from an icon context menu enables you to run tasks from the following two windows that proide quick paths to managing WebSphere MQ resources: Queue Manager Control Center The Queue Manager Control Center window proides a list of all queue managers in the management domain. You select queue managers from this window, and use the Action menu to perform operations on the selected queue manager. Information Center An Information Center window proides a list of the type of WebSphere MQ resources that you select (queues, channels, processes, name lists, authentication information objects, or proxy mode z/os coupling facility structures). You select resources from this window, and use the Action menu to perform operations on the selected resource. Workflow Serice Window The Workflow Serice Window proides a list of Workflow serices that you can select and perform an action on from the Action menu. See Using the Workflow Serices window on page 209. Required authorization roles For a list of the authorization roles required for IBM Tioli Monitoring for Business Integration tasks, see Appendix A, Authorization roles quick reference, on page 315. Before you begin Not applicable. When you finish Not applicable. Procedure You can perform this procedure from an icon context menu or from a task library. 144 IBM Tioli Monitoring for Business Integration: User s Guide

169 In IBM Tioli Monitoring for Business Integration: WebSphere MQ, you can also perform this procedure from the Queue Manager Control Center or from an Information Center. Task library: 1. Open the task library window by doing the following: a. Double-click a policy region icon to open the policy region. Note: IBM Tioli Monitoring for Business Integration: WebSphere MQ: The Monitoring for WebSphere MQ policy region contains the MQS Utility Tasks task library. b. For IBM Tioli Monitoring for Business Integration: WebSphere MQ only: Access the task libraries that contain operational tasks by doing the following: 1) Double-click a management domain icon. 2) Double-click the MQSeries Tasks policy region c. Double-click the appropriate task library icon to open the task library window. Figure 9. Task library window 2. Double-click the task icon that you want to run to open the Execute Task window. Additional Information: The Execute Task window is a generic window of execution parameters for all tasks. Chapter 8. Working with tasks and jobs 145

170 Figure 10. Execute Task window 3. Select one of the following check boxes in the Execution Mode section: Parallel runs the task simultaneously on all targets. Parallel is typically the fastest method of execution. OR Serial runs the task sequentially on all targets in alphabetical order. OR Staged runs the task on all targets in alphabetical order according to a schedule you specify. Staged execution is useful if you run the task on a large number of endpoints. Specify the Staging Count (number of targets to run against for each stage) and the Staging Interal (number of seconds between each set). 4. Type a timeout alue (in seconds) for the task in the Timeout text box. The default timeout alue is 60 seconds. Additional Information: The Timeout alue does not stop the task. This alue specifies the number of seconds the desktop waits for the task to complete before it issues an error. If a timeout occurs, the desktop issues an error similar to the following: M53D@NMPIPL33 (MqM_QMgr): The task failed to execute. M53D@NMPIPL33 (MqM_QMgr): FRWTD0026E The task failed to complete execution before the timeout period expired. 146 IBM Tioli Monitoring for Business Integration: User s Guide

171 Howeer, the task continues to run on the endpoint without displaying output results. If the task takes longer to complete than the specified Timeout alue and is running in Serial or Staged mode, the product moes on to other endpoints after this time expires. Note: This timeout alue applies to standard tasks that are run from a task library and not to icon context menu tasks. 5. Select one or more of the following check boxes in the Output Format section to choose the output returned upon task completion: Header Includes a descriptie header for each record, such as the task name and target. Return Code Includes the command return codes produced when the task executes. Standard Error Includes all error messages encountered when the task executes. Standard Output Includes all information that results from the task execution. 6. Click one of the following in the Output Destination section to choose an output destination: Click Display on Desktop to open the task output window on the desktop. Additional Information: If you choose Display on Desktop, you hae an option to sae the information to a file as an option in the output window. OR Click Sae to File to sae the output to a file. To sae the task output to a file, do the following: a. Select the Sae to File check box in the Output Destination section to open the Destination for Task Output window. Figure 11. Destination for Task Output window b. Type the name of the endpoint on which to sae the output in the On Host text box. c. Type the absolute path name for the output file in the Output File text box. Additional Information: Example: /tmp/mytask.out d. Click Set & Close to set your choices and return to the Execute Task window. 7. Choose the endpoints on which you want to run the task by doing one of the following: Run the task on specific endpoints by doing the following: Chapter 8. Working with tasks and jobs 147

172 a. Click the endpoints on the Aailable Task Endpoints list. b. Click the left arrow button to moe the selected endpoints to the Selected Task Endpoints list. OR Run the task on all subscribers of the specified profile managers by doing the following: a. Click the profile managers on the Aailable Profile Managers list. b. Click the left arrow button to moe the selected profile managers to the Selected Profile Managers list. 8. Click Execute to open the task argument window. Additional Information: For information about how to fill in the task argument window, refer to the task description in the reference guide for the IBM Tioli Monitoring for Business Integration component or click Task Description or Help to open the online help. 9. Click Set & Execute to run the task. Icon context menu: Note: Icon context menu tasks do not work in interconnected regions. Install IBM Tioli Monitoring for Business Integration: WebSphere MQ in all regions before running the wupdate command to update shared resources. 1. Right-click an icon to open the icon context menu such as the example in Figure 12. Figure 12. Icon context menu 2. Click the menu item for the task you want to run (or the information you want to see). 3. If a window opens, complete the fields or select the desired options. See the reference guide for the software that you are using for more information about the fields and options for specific tasks: IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide For more information about the tasks that are aailable on the icon context menus, see Appendix B, Context menu quick reference, on page 325. IBM Tioli Monitoring for Business Integration: WebSphere MQ windows: 148 IBM Tioli Monitoring for Business Integration: User s Guide

173 Queue Manager Control Center window: To run a task from the Queue Manager Control Center window, follow these steps: 1. Open the Policy Region: Monitoring for WebSphere MQ window by double-clicking the Monitoring for WebSphere MQ icon on the Tioli desktop. Figure 13. Policy Region: Monitoring for WebSphere MQ window 2. Right-click the appropriate management domain icon to open the icon context menu. Figure 14. Icon context menu for a management domain Chapter 8. Working with tasks and jobs 149

174 3. Click Queue Manager Control Center on the icon context menu to open the Queue Manager Control Center window. Figure 15. Queue Manager Control Center window 150 IBM Tioli Monitoring for Business Integration: User s Guide

175 The Queue Manager Control Center window contains a list of all queue managers in the management domain. The window proides the following columns of data: State Indicates whether the queue manager is running, stopped, unknown, or deleted. If configuration data has been preiously saed, the deleted status indicates that the queue manager object has been deleted, but the queue manager configuration data still exists in the Tioli Inentory database. For more information, refer to the information about Inentory tasks in the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Sae Date Indicates the date on which the queue manager configuration was saed in the Tioli Inentory database. For more information, refer to the information about Inentory tasks in the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Queue Manager Proides the name of the queue manager and the host name on which the queue manager is configured in the following format: queue_manager@hostname. For more information about this resource name, see When you finish on page 178. Status Indicates the progress of the Inentory task being performed. 4. Click one or more queue managers in the list. 5. Click Action to open the menu containing the groups of tasks that you can run on the queue managers. Figure 16. Action menu aailable from the Queue Manager Control Center window Chapter 8. Working with tasks and jobs 151

176 6. Click the group for the task you want to run to open the menu of tasks. 7. Click the task the task you want to run. Information Center window: When you select Queues, Channels, Process, Name List, Authentication, or OS/390 Coupling Facility from a queue manager icon context menu, an Information Center window opens, which contains a list of all the resources of the type you selected. From the Information Center window, you can run a queue, channel, process, name list, authentication, or coupling facility task against one or more of the listed resources. Assume that you want to change the properties of a local queue. To do this, follow these steps: 1. From the management domain policy region, right-click the appropriate queue manager icon and click Queue Local Queue on the icon context menu. The Queue Information Center window opens, which contains a list of all the local queues for the selected queue manager. Figure 17. Queue Information Center window 2. From the Queue Information Center window, double-click the appropriate local queue. The Change Local Queue window opens, which contains the current attributes of the selected local queue. Note: If you select Change from the Action menu, the Change Local Queue window is not populated with the current attributes of the selected queue. 3. On the Change Local Queue window, change the appropriate attributes and click Set and Execute. Notes: 1. The Information Center window will not be opened if IBM Tioli Monitoring for Business Integration: WebSphere MQ is unable to create a list of the resources of the type you selected. In this case, a task output window opens containing the results of the appropriate Display task (Display Queue, Display Authentication, Display Channel, Display Coupling Facility, Display Process, or 152 IBM Tioli Monitoring for Business Integration: User s Guide

177 Display Name List). IBM Tioli Monitoring for Business Integration: WebSphere MQ might be unable to create a list of resources for the following reasons: No objects of this type hae been created, and the SYSTEM.DEFAULT of this object does not exist. To correct this problem, create a SYSTEM.DEFAULT object using the appropriate IBM Tioli Monitoring for Business Integration: WebSphere MQ task. Coupling Facility objects are an exception in that these objects do not hae a SYSTEM.DEFAULT object. The queue manager icon shows that the status of the queue manager is down. If you know that the queue manager is running, ping the queue manager to update the status of the queue manager icon. Then open the Information Center window again. For proxy mode z/os, the connection between the IBM Tioli Business Systems Manager task serer and proxy mode z/os is down. Check the connection to proxy mode z/os. 2. To create, change, or delete a queue or channel, select the specific type of queue or channel from the queue manager icon context menu. Then click the appropriate action from the Information Center Action menu. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator windows: See Using the Execution Groups window on page 232 for information about the following windows: Execution Groups Message Flows IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer windows: 1. Open the Adapter Controllers window or Collaborations window to display the name and status of the adapter controllers or collaborations currently defined in the InterChange Sererby doing the following: a. Right-click a WICSerer icon. b. Select Open. c. Select one of the following: Adapter Controllers to open the Adapter Controllers window. OR Collaborations to open the Collaborations window. OR ICS logs to open the ICS logs window. OR Tioli logs to open the Tioli logs window. Additional information: When the task completes, a window opens showing the adapter controllers or collaboration resources currently defined in the InterChange Serer. The window has three sections that show the status of these resources. 2. Click the resource on which you want to perform an action from any of the lists. 3. Click the operation that you want to perform from the menu. Chapter 8. Working with tasks and jobs 153

178 Changing the timeout alue for a WebSphere MQ icon context menu task Objectie To change the timeout alue on the endpoint or the gateway, or both, for an icon context menu task to preent the task from timing out in IBM Tioli Monitoring for Business Integration: WebSphere MQ. Background information This task is for IBM Tioli Monitoring for Business Integration: WebSphere MQ only. The default timeout alue on the endpoint for icon context menu tasks is 300 seconds. The default timeout alue on the gateway is 300 seconds. An icon context menu task times out when it reaches the lesser of the endpoint timeout alue or the gateway timeout alue. For example, if you change the endpoint timeout alue to 600 seconds, and you keep the default gateway timeout alue (300 seconds), the task times out at 300 seconds. Note: This timeout alue does not apply to standard tasks that are run from a task library. The default timeout alue for standard tasks is 60 seconds. Note: On OS/400, you must increase the timeout alue to preent tasks from timing out. When a task times out on the endpoint, a message similar to the following is displayed: M53D@NMPIPL33 (MqM_QMgr): The task failed to execute. M53D@NMPIPL33 (MqM_QMgr): FRWTD0026E The task failed to complete execution before the timeout period expired. When a task times out on the gateway, a message similar to the following is displayed: fipl10 (Endpoint): The task failed to execute. fipl10n (Endpoint): Data was not receied because the session timed out. rec_session: timeout (300 seconds) waiting to receie from CTQ9008I Task Completed. Required authorization roles MQS_senior or MQS_domain_name_senior admin Before you begin Not applicable. When you finish All icon context menu tasks within a management domain, except for Clone and Create Management Domain, use the timeout alue you specify. Procedure You can perform this procedure from a management domain icon context menu only. 1. From within the Monitoring for WebSphere MQ policy region, right-click the appropriate management domain icon and Click Set Task Timeout Value on the icon context menu. The Set Task Timeout Value window opens. 2. Type the timeout alue in seconds in the Seconds text field. 154 IBM Tioli Monitoring for Business Integration: User s Guide

179 Customizing a task 3. Optionally, select one or more gateways in the Gateway Host field to change the gateway timeout alue equal to the alue set for the endpoint in the Seconds field. This field shows the current timeout alue for each gateway. 4. Click Set. Objectie To customize one of the standard tasks in the task library so you can sae defined arguments for future executions. This task applies only to IBM Tioli Monitoring for Business Integration: WebSphere MQ. Background information A customized task is a standard task with defined arguments saed in the task library with a unique name. For example, you can customize a task to sae task output results to a file after each execution. Because you can customize task arguments, the Tioli enironment does not open argument windows when you run the task from the desktop. Howeer, if you run a customized task from the command line, you still must specify the task arguments. Running a customized task requires additional information before it runs, such as the target of the execution. You can customize only those IBM Tioli Monitoring for Business Integration: WebSphere MQ tasks that do not hae arguments and the following IBM Tioli Monitoring for Business Integration: WebSphere MQ tasks: Inentory tasks: Sae Restore Utility tasks: Delete_Endpoint_Log_Files Display_Endpoint_Enironment Initialize_Endpoints Uninstall_Endpoints_ManagedNodes Queue Manager tasks: Discoer_Queue_Mgrs Start_DLQ_Handler Stop_DLQ_Handler Required authorization roles admin Before you begin Not applicable. When you finish You can run the task from the appropriate task library by following the procedure in Running a task on page 143. When you run a customized task, the Tioli desktop does not open the task argument window. Chapter 8. Working with tasks and jobs 155

180 Procedure Desktop: 1. Open the task library window by doing the following: a. Double-click a policy region icon to open the policy region: Monitoring for WebSphere MQ The MQS Utility Tasks task library is located in the Monitoring for WebSphere MQ policy region. b. To access the task libraries that contain operational tasks, double-click the management domain icon, then double-click the policy region containing the tasks. c. Double-click the appropriate task library icon to open the task library window. 2. Double-click a task icon to open the Execute Task window for that task. Additional Information: The Execute Task window is a generic window of execution parameters for all tasks. Complete this window to run the task as described in Running a task on page 143. Figure 18. Execute task window 3. Click Execute to open the task argument window box. 156 IBM Tioli Monitoring for Business Integration: User s Guide

181 Additional Information: Each standard task has a unique task argument window. Below is one example of a task argument window. Figure 19. Task argument window 4. Enter the appropriate alues for this customized task. Additional Information: For information about each field in these windows, see the task description in the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide or click Task Description to open the online help. 5. Click Sae to open the window for saing the argument. Figure 20. Window for saing the argument 6. Type the following information to define the customized task: a. Type a name for the customized task in the Name text box. Additional Information: This name appears in the Library Contents field so you can iew the customized tasks that are based on the parent task. b. Type an identifier for this task. Additional Information: An identifier is the name of the task icon in the Task Library window. A customized task identifier has two parts. The first part should be the standard task name (such as Discoer_Queue_Managers ). Chapter 8. Working with tasks and jobs 157

182 The second part should be descriptie information that makes sense to you. For example, you could type SYS. The resulting task name would be Discoer_Queue_Managers_SYS. The software generates a unique default name (such as Discoer_Queue_Managers_aaa ) if no identifier is entered. To enable filtering for an identifier without the standard task name, edit the tl_def_man_nodes policy method in the task library policy object. See the Tioli Management Framework Reference Manual for more information. c. Type a description of this task in the Description text box. Additional Information: This description appears when you click Task Description in the task argument window for this customized task. d. Optional: Select the Show by Identifier check box to change the Library Contents list to use the task identifier instead of the task name. e. Optional: Click Parent Description to display information about the parent task from which you are creating a customized task. Additional Information: The task information appears under the heading Description. f. Click Sae & Close to return to the task argument window. 7. Click Cancel in the task argument window. 8. Click Close in the Execute Task window to return to the Task Library window. 9. Click View Refresh to display the new customized task. Creating a job Objectie To create a job by defining execution parameters so you can specify a target enabling you to schedule it to run at certain times in the Scheduler. This task applies to the following IBM Tioli Monitoring for Business Integration components: IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Background information A job is a task with defined and saed arguments that can be executed many times on specific managed resources. You can create jobs from both standard and customized tasks in the product task library. Like tasks, you store jobs in task libraries so you can reuse them. A customized task is a standard task with defined arguments saed in the task library with a unique name. For example, you can customize a task to sae task output results to a file after each execution. Because you can customize task arguments, the Tioli enironment does not open argument windows when you run the task from the desktop. Howeer, if you run a customized task from the command line, you still must specify the task arguments. Running a customized task requires additional information before it runs, such as the target of the execution. You can create jobs from only those IBM Tioli Monitoring for Business Integration: WebSphere MQ tasks that do not hae arguments and from the following IBM Tioli Monitoring for Business Integration: WebSphere MQ tasks: Inentory tasks: 158 IBM Tioli Monitoring for Business Integration: User s Guide

183 Sae Restore Utility tasks: Delete_Endpoint_Log_Files Display_Endpoint_Enironment Initialize_Endpoints Uninstall_Endpoints_ManagedNodes Queue Manager tasks: Discoer_Queue_Mgrs Start_DLQ_Handler Stop_DLQ_Handler Required authorization roles admin Before you begin Not applicable. When you finish After you create a job, you can run it immediately using the procedure described in Running a job on page 162. You also can schedule jobs to run at certain times in the Scheduler, as described in Scheduling a job on page 163. Procedure You can perform this procedure from either the Tioli command line or the desktop. Command line: Use the wcrtjob command to create jobs from the command line. The syntax is as follows: wcrtjob j job_name l library_name t task_name M mode [ s interal n number] m timeout o output_format [ D d mannode_name f file_name] [ h mannode_name] [ p prof_manager_name] where: j job_name The name of the job being created. Job names can include any alphanumeric character, an underscore (_), a dash ( ), a period (.), and a space. l library_name Specifies the task library containing the task to be included in the job. t task_name Specifies the name of the task to include in the job. M mode Specifies the mode in which the job runs. Valid options are as follows: parallel Runs the job on all specified endpoints and any subscribers simultaneously. serial Runs the job on one endpoint at a time. staged Runs the job on a set number of endpoints at specified interals. Chapter 8. Working with tasks and jobs 159

184 Desktop: 1. Access the task library window by doing the following: a. Double-click the policy region icon to open the policy region. b. Double-click the task library icon to open the task library window. 2. Click Create to open the Create drop-down menu. 3. Click Job from the Create drop-down menu to open the Create Job window. Figure 21. Create Job window 4. Type a descriptie job name in the Job Name text box. Additional Information: The job name identifies the icon on the desktop. The name must be unique and can include any alphanumeric character, an underscore (_), dash ( ), period (.), or blank space. 5. Click the task on which the job is based in the Task Name list. 6. In the Execution Mode section, select one of the following check boxes: 160 IBM Tioli Monitoring for Business Integration: User s Guide

185 Parallel Runs the task simultaneously on all targets. Parallel is typically the fastest method of execution. Serial Staged OR Runs the task sequentially on all targets in alphabetical order. OR Runs the task on all targets in alphabetical order according to a schedule you specify. Staged execution is useful if you are running the task on a large number of endpoints. Complete Step 8 to specify the Staging Count (number of targets to run against per stage) and the Staging Interal (number of seconds between each set). 7. In the Execution Parameters section, type the timeout alue (in seconds) for the task in the Timeout text box. Additional Information: This alue specifies the number of seconds the product waits for the task or job to complete before it issues an error. The default is 60 seconds. If the task takes longer to complete than the specified Timeout and is running in Serial or Staged mode, the product moes on to other endpoints after this time expires. The task continues to execute on the endpoint, een though the product stopped waiting for it to end. 8. Optional: If you selected Staged in Step 6, specify the number of endpoints to include in each staged set in the Staging Count text box and the number of seconds between each set s startup time in the Staging Interal text box. 9. Select one or more of the following check boxes to choose the output type in the Output Format section: Header Includes a descriptie header for each record. Return Code Includes the command return codes produced when the job executes. Standard Error Includes all error messages encountered when the job executes. Standard Output Includes all information that results from the job execution. 10. Do one of the following in the Output Destination section to choose an output destination: Click Display on Desktop to open the job output on the desktop. Go to Step 12. Additional Information: If you choose Display on Desktop, you hae an option to sae the information to a file as an option inside the output window. OR Click Sae to File to sae the output to a file and open the Destination for Task Output window. Go to Step 11. Chapter 8. Working with tasks and jobs 161

186 Figure 22. Destination for Task Output window 11. Do the following in the Destination for Task Output window to sae the job output to a file: a. Type a Tioli client endpoint name on which to sae the output in the On Host text box. b. Type the absolute path name for the output file in the Output File text box. Additional Information: Example: /tmp/myjob.out c. Click Set & Close to set your choices and return to the Create Job window. 12. Do one of the following to choose the endpoints on which to run the job: Run the job on specific endpoints by doing the following: a. Click the endpoints in the Aailable Task Endpoints list. b. Click the left arrow button to moe the selected endpoints to the Selected Task Endpoints list. OR Run the job on all subscribers of the specified profile managers by doing the following: a. Select profile managers from the Aailable Profile Managers list. b. Click the left arrow button to moe the selected profile managers to the Selected Profile Managers list. 13. Click Create & Close to create the job and return to the Task Library window. Additional Information: The new job icon appears in the Task Library window. Running a job Objectie To execute a job on specific endpoints immediately so you can perform a management operation. This task applies to the following IBM Tioli Monitoring for Business Integration components: IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Background information If you created a job from a standard task, the Tioli desktop opens the task argument window so that you can fill in any required information. Jobs created from customized tasks run without further input because all required information is specified. (See Customizing a task on page 155 for information about how to create a customized task.) 162 IBM Tioli Monitoring for Business Integration: User s Guide

187 Scheduling a job Required authorization roles For a list of the authorization roles required for running tasks, see Appendix A, Authorization roles quick reference, on page 315. Before you begin Not applicable. When you finish After you create a job, you can set it up to run on a regular schedule as described in Scheduling a job on page 163. Procedure You can perform this procedure from either the Tioli command line or the desktop. Command line: Use the wrunjob command to run jobs from the command line. For more information about this command, see the Tioli Management Framework Reference Manual. Desktop: 1. Open the task library window by doing the following: a. Double-click a policy region icon to open the policy region: Monitoring for WebSphere MQ Monitoring for WebSphere MQI Monitoring for WebSphere ICS The MQS Utility Tasks task library is located in the Monitoring for WebSphere MQ policy region. b. To access the task libraries that contain operational tasks, double-click the management domain icon, and then double-click the policy region that contains the task you want to run. c. Double-click the appropriate task library icon to open the task library window. 2. Do one of the following: For a customized task: Double-click the job icon created from a customized task to begin executing the job. OR For a standard task: a. Double-click the job icon created from a standard task. b. Type the alues in the task window using the information about specific fields in the task description in the reference guide for the software you are using, or click Task Description to open the online help. Additional Information: The software runs the job and displays the output on the desktop or sends it to a file in accordance with the job specification. Objectie To schedule jobs to occur regularly so you can routinely perform management operations. Chapter 8. Working with tasks and jobs 163

188 This task applies to the following IBM Tioli Monitoring for Business Integration components: IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Background information IBM Tioli Monitoring for Business Integration uses Scheduler to schedule jobs. Scheduler is a serice that enables you to run jobs unattended. You can schedule a job to run one time or multiple times. You select the way that Scheduler notifies you when a job is complete. To schedule a job, the job must exist in the task library. You can schedule the following jobs based on the following tasks in IBM Tioli Monitoring for Business Integration: WebSphere MQ: <domain_name>_discoer_queue_mgrs <domain_name>_stop_dlq_handler <domain_name>_start_dlq_handler MQS_Uninstall_Endpoints_ManagedNodes MQS_Display_Endpoint_Enironment MQS_Delete_Endpoint_Log_Files MQS_Initialize_Endpoints Required authorization roles For a list of the authorization roles required for IBM Tioli Monitoring for Business Integration tasks, see Appendix A, Authorization roles quick reference, on page 315. Before you begin You create a job by following the procedure described in Creating a job on page 158. When you finish Not applicable. Procedure You can perform this procedure from either the Tioli command line or the desktop. Command line: Use the wschedjob command to schedule a job in the Task Library from the command line. You can only schedule jobs that already exist in the task library from the command line. For more information, see the Tioli Management Framework Reference Manual. Desktop: 1. Open the task library window by doing the following: a. Double-click a policy region icon to open the policy region: Monitoring for WebSphere MQ Monitoring for WebSphere MQI Monitoring for WebSphere ICS The MQS Utility Tasks task library is located in the Monitoring for WebSphere MQ policy region. 164 IBM Tioli Monitoring for Business Integration: User s Guide

189 b. To access the task libraries that contain operational tasks, double-click the management domain icon, and then double-click the policy region that contains the task library with the task you want to run. c. Double-click the appropriate task library icon to open the task library window. 2. Drag the job icon that you want to schedule onto the Scheduler icon located on the Tioli desktop. 3. Optional: Do the following if a task argument window opens: a. Type the appropriate information for each field in the window. Additional Information: Refer to the task description in the reference guide for the software you are using, or click Task Description to open the online help for this task. b. Click Set & Execute to set the task arguments and open the Add Scheduled Job window. Figure 23. Add Scheduled Job window Chapter 8. Working with tasks and jobs 165

190 4. Type a label for the job icon in the Job Label text box of the Add Scheduled Job window. Additional Information: The label identifies the icon on the desktop. The job label can include alphanumeric character, underscores (_), dashes ( ), periods (.), and blanks. If you do not specify a label, the job name is used. 5. Do one of the following: Select the Disable the Job check box to stop a scheduled job from running. OR Clear the Disable the Job check box to continue running a scheduled job. Additional Information: For more information on job disabling, see the Tioli Management Framework User s Guide. 6. Optional: Type a job description to uniquely identify the job in the Description field. 7. Set the date and time to begin scheduling in the Schedule Job For section: a. Type a date in the Month, Day, and Year text boxes. b. Enter the time using the Hour and Minute drop-down lists and the AM and PM radio buttons. 8. Optional: Repeat the job by doing the following in the Repeat the Job section: a. Do one of the following: Select the Repeat the job indefinitely check box to repeat the job indefinitely. OR Repeat the job a finite number of times by doing the following: 1) Select the Repeat the job check box. 2) Type the number of times you want the job to run. b. Set the interal between start times for the job in the The job should start eery field. 9. Select any of the following check boxes in the When Job Completes section to send job completion notification: Send a notice to a specific group by doing the following: a. Select the Post Tioli Notice check box. b. Click Aailable Groups to open the Aailable Groups window. c. Click a group in the list of notice groups. d. Click Set to set your group and return to the Add Scheduled Job window. Additional Information: You can read notices from the Tioli desktop by clicking on the Notices icon. Send a notice to your desktop by doing the following: a. Select the Post Status window on Desktop check box. b. Type the message you want displayed in the text box next to the check box. Send an to a specified user by doing the following: a. Select the Send to check box. b. Type the complete address in the text box next to the check box. Log the job completion status to a file by doing the following: a. Select the Log to File check box. 166 IBM Tioli Monitoring for Business Integration: User s Guide

191 b. Enter the file destination by doing one of the following: Type the file destination in the Host and File text boxes. OR Browse for the file destination by doing the following: 1) Click File Browser to open the File Browser window. 2) Double-click on a host name to open the directories and files for that host. 3) Click a directory and file in the Directories and Files lists. 4) Click Set File & Close to return to the Add Scheduled Job window. 10. Optional: Set retry, cancel, or restriction options by doing the following: a. Click Set Retry/Cancel/Restriction Options to open the Set Retry/Cancel Restrictions Options window. Figure 24. Set Retry/Cancel/Restriction Options window b. Choose one of the following cancel job options: Clear the Cancel job check box to hae the Scheduler continue trying the job indefinitely. OR Set the Scheduler to cancel a job in a specified time frame by doing the following: 1) Select the Cancel job check box. 2) Type the time frame for the Scheduler to wait before canceling a job that has not started. c. Click one of the following retry options: Click Retry the job until success to retry the job until it runs successfully. Chapter 8. Working with tasks and jobs 167

192 OR Specify the number of times a job attempts to run by doing the following: 1) Select the Retry the job check box. 2) Type the number of attempts to start the job in the text box. 3) Type the amount of time the Scheduler waits before retrying in the The job should retry eery field. d. Select any of the following check boxes in the Restrictions section to specify the job run times: During the day Set the beginning and ending hour of day for the job to run. At night Set the beginning and ending hour of night for the job to run. During the week Set the beginning and ending day of the week for the job to run. On weekends Set the beginning and ending day of the weekend for the job to run. e. Click Set to set the options and return to the Add Scheduled Job window. 11. Click Schedule Job & Close to schedule the job and return to the Tioli desktop. 168 IBM Tioli Monitoring for Business Integration: User s Guide

193 Part 2. IBM Tioli Monitoring for Business Integration: WebSphere MQ Copyright IBM Corp

194 170 IBM Tioli Monitoring for Business Integration: User s Guide

195 Chapter 9. Quick-reference guide for IBM Tioli Monitoring for Business Integration: WebSphere MQ This chapter proides a quick-reference table of the setup procedures you must perform before you can use IBM Tioli Monitoring for Business Integration: WebSphere MQ. Table 22 includes cross-references to places where you can find additional information about each of these procedures. Table 22. Quick-reference information for getting started with IBM Tioli Monitoring for Business Integration: WebSphere MQ Goal Starting 1. Access the Tioli enironment so you can manage and monitor your queue manager enironment. Setting up administrators to use the software 2. Authorize persons to hae the roles they need for managing resources in the product. Note: You must assign both Tioli and WebSphere MQ authorization roles to administrators in the policy regions that you want them to administer. Setting up managed resources 3. Change the mapping of the irtual user ID. (Optional) 4. Create the management domains that will contain the WebSphere MQ resources that you want to manage. 5. Populate the management domains with the WebSphere MQ resources you want to manage. Setting up monitoring profiles and tasks Where to find procedures Accessing the Tioli Management Framework enironment on page 32 Setting authorization roles on page 33 Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere MQ on page 315 lists the authorization roles required for each procedure. Use the Edit Default Policies window in an IBM Tioli Monitoring profile to set the user and group IDs for the profile. See the Tioli Management Framework User s Guide for information about how to assign authorization roles to Tioli administrators. Changing the mapping of the irtual user ID for WebSphere MQ on page 173 Creating a management domain on page 175 Populating the management domains on page Set up customized tasks. Customizing a task on page Set up and schedule jobs from tasks. Chapter 8, Working with tasks and jobs, on page Set up the resource models that you want to run: Set up the suggested resource models and run them for a period of time. Remoe any resource models that are not necessary for your enironment. Also see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide for information about specific tasks. Chapter 3, Working with resource models, on page 49. Also see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide for information about specific resource models. (Optional) View daily reports in the IBM Tioli Monitoring Web Health Console Copyright IBM Corp

196 Table 22. Quick-reference information for getting started with IBM Tioli Monitoring for Business Integration: WebSphere MQ (continued) Goal View statistics regarding your enironment in the IBM Tioli Monitoring Web Health Console. Where to find procedures (Optional) Create historical reports in the Tioli Enterprise Data Warehouse Configure Tioli Enterprise Data Warehouse to iew enironmental data for troubleshooting and performance tuning. (Optional) Connecting to IBM Tioli Enterprise Console Set up IBM Tioli Enterprise Console so you can iew actiity reports for your enironment. (Optional) Connecting to the IBM Tioli Business Systems Manager Set up IBM Tioli Business Systems Manager so that you can monitor potential problems in your enironment. Chapter 4, Viewing resource model results with the IBM Tioli Monitoring Web Health Console, on page 73 Chapter 5, Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse, on page 75 Chapter 6, Integrating with IBM Tioli Enterprise Console, on page 93. Chapter 7, Integrating with IBM Tioli Business Systems Manager, on page IBM Tioli Monitoring for Business Integration: User s Guide

197 Chapter 10. Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ This chapter proides an oeriew of the steps you must complete to configure IBM Tioli Monitoring for Business Integration: WebSphere MQ, and it proides some important information about using IBM Tioli Monitoring for Business Integration: WebSphere MQ. Table 23 shows the tasks that are required to configure IBM Tioli Monitoring for Business Integration: WebSphere MQ and where to find the procedures. Table 23. Configuring IBM Tioli Monitoring for Business Integration: WebSphere MQ Goal 1. Access the interfaces in the Tioli enironment so you can use the operations and functions of IBM Tioli Monitoring for Business Integration: WebSphere MQ 2. Assign the IBM Tioli Monitoring for Business Integration: WebSphere MQ authorization roles to one or more Tioli administrators. 3. Optionally, change the irtual user ID mapping for WebSphere MQ. 4. Create the management domains that will contain the WebSphere MQ resources that you want to manage. 5. Populate the management domains with the WebSphere MQ resources you want to manage. Where to find procedures Accessing the Tioli Management Framework enironment on page 32 Setting authorization roles on page 33 Changing the mapping of the irtual user ID for WebSphere MQ Creating a management domain on page 175 Populating the management domains on page 176 Changing the mapping of the irtual user ID for WebSphere MQ Objectie To change the mapping of the irtual user ID, $tmemqs_user, under which IBM Tioli Monitoring for Business Integration: WebSphere MQ tasks are run. Background information Table 24 shows the default mapping for $tmemqs_user. Table 24. Virtual user ID mapping for operating systems for IBM Tioli Monitoring for Business Integration: WebSphere MQ Operating system AIX UNIX Solaris Linux-ix16 Linux-s390 Windows¹ OS/400 $tmemqs_user mqm mqm mqm mqm mqm MUSR_MQADMIN mqm Copyright IBM Corp

198 Table 24. Virtual user ID mapping for operating systems for IBM Tioli Monitoring for Business Integration: WebSphere MQ (continued) Operating system $tmemqs_user ¹To support the irtual ID mapping to MUSR_MQADMIN on Windows, the Discoer Queue Managers, Create Queue Manager, and Create Queue Mgr Icon tasks modify the permissions on the system LCF_TEMPDIR directory to gie full access to all users. Required authorization roles super Before you begin Ensure that the new user ID meets the following requirements: Is defined on all applicable endpoints, for proxy mode z/os, on the IBM Tioli Business Systems Manager task serer that is used to communicate with proxy mode z/os. Is a member of the mqm group. Has read and write permissions to the directory in which eent adapter cache files are written. The directory is specified by the BufEentPath keyword in each eent adapter configuration file, tecad_mqseries.qmgrname.cfg. The configuration file is located in the following directory: $LCF_BINDIR/../../generic_unix/TME/MQS/teccfg By default, the eent adapter cache files are written to the following directory: $LCF_BINDIR/../../generic_unix_TME/MQS/teccfg/qmgrname Where qmgrname is the name of the queue manager associated with the cache file. Has read and write permissions to the directory in which the trace files are written. The trace files are written to the following directory: $LCF_DATDIR/LCFNEW/CTQ/tmp The temporary files are written to the following directory: $LCF_DATDIR/LCFNEW/CTQ/tmp Has read and write permissions to the directory in which the dead-letter queue handler rule sets are written. The rule sets are written to the following directory: $LCF_BINDIR/../../generic_unix_TME/MQS/dlqrulesets Do not use DBCS user and group IDs as tmemqs irtual IDs. When you finish Changing the mapping of the $tmemqs_user affects the user ID under which the resource models run. When you run WebSphere for MQSeries on an OS/400 operating system and you mapped tmemqs_user to a user profile with *USER authority, the Display Command Serer status always displays STOPPED. Grant the user Special authority *JOBCTL. Procedure You can run this task from the Tioli desktop only. For instructions on running a task, see Chapter 8, Working with tasks and jobs, on page 141. For information about the MQ User ID Mapping task, see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. 174 IBM Tioli Monitoring for Business Integration: User s Guide

199 For more information about IBM Tioli Monitoring for Business Integration: WebSphere MQ for proxy mode z/os system requirements, refer to the Program Directory for IBM Tioli Monitoring for Business Integration: WebSphere MQ for z/os. Creating a management domain Objectie To create a management domain to contain the WebSphere MQ resources you want to manage. Background information A management domain is a policy region that contains WebSphere MQ resources. You must create at least one management domain to contain the WebSphere MQ resources you want to manage. If you hae a large number of WebSphere MQ resources in your enterprise and multiple administrators who monitor and manage these resources, you can create multiple management domains. For example, you might want to create your management domains based on geographical or organization boundaries. Because each WebSphere MQ management domain is a policy region that requires different authorization roles, you can assign authorization roles to one or more administrators based on responsibilities. IBM Tioli Monitoring for Business Integration: WebSphere MQ creates the management domain within the Monitoring for WebSphere MQ policy region. IBM Tioli Monitoring for Business Integration: WebSphere MQ prepends the name of your management domain with MQS_. For example, if you name your domain Dom5, its icon label is MQS_Dom5. This name is used in the names of the profile managers, the MQSeries Tasks policy region, and the task libraries that are automatically created within the management domain. For each management domain that is created, an object is created in the Tioli database. The MQS_domain_name Resource Models profile manager is also created, which contains the MQS_domain_name Resource Models profile. The MQS_domain_name Resource Models profile contains the following resource models with the default configuration: WebSphere MQ Queue Manager WebSphere MQ Queue WebSphere MQ Channel WebSphere MQ Error Log By default, the WebSphere MQ Queue and the WebSphere MQ Channel, and WebSphere MQ Error Log resource models are disabled. For information about the default settings for the resource models, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Table 25 describes the icon, resource type, and icon name for a management domain object. Table 25. IBM Tioli Monitoring for Business Integration: WebSphere MQ management domain icon Icon Resource type Icon name Management domain MQS_DomainName Example: MQS_rmeli Chapter 10. Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ 175

200 where: DomainName Is the name you specified when you created the management domain. Note: If you want to delete a management domain, enter the following command: mqsuninst rmdom domain_name For more information about the mqsuninst command, refer to the IBM Tioli Monitoring for Business Integration Installation and Setup Guide. Required authorization roles MQS_senior super Before you begin Not applicable. When you finish After you create one or more management domains, you can populate the management domains with the WebSphere MQ resources that you want to manage. See Populating the management domains. Procedure 1. Right-click the Monitoring for WebSphere MQ icon and select Create Management Domain from the icon context menu to open the Create Management Domain window. 2. Type the name for your management domain. Domain names must be unique and can include only the following characters: Letters of the English alphabet Numeric digits The underscore character (_) 3. Click Set and Execute. Populating the management domains Objectie To create an object for each queue manager you want to manage. Background information When you create a management domain, the management domain contains all the profile managers, task libraries, and other objects needed to manage WebSphere MQ resources, but it does not initially contain any queue manager objects. To manage your WebSphere MQ resources, you must create an object for each queue manager you want to manage. IBM Tioli Monitoring for Business Integration: WebSphere MQ, by default, creates queue manager objects on the endpoint s current gateway. Whether you run the Discoer Queue Managers, the Create Queue Manager, or the Create Queue Manager Icon task, you can create the queue manager objects on any managed node on which IBM Tioli Monitoring for Business Integration: WebSphere MQ is 176 IBM Tioli Monitoring for Business Integration: User s Guide

201 installed. You might do this if you are concerned about gateway failure or if you want to create all queue managers objects on one machine that will function as your object depot. By default, the MQS_domain_name Resource Models profile is automatically distributed to the queue managers that are discoered or created een if the profile has been preiously distributed. The MQS_domain_name Resource Models profile contains the following resource models with the default configuration: WebSphere MQ Queue Manager WebSphere MQ Queue WebSphere MQ Channel WebSphere MQ Error Log By default, the WebSphere MQ Queue, WebSphere MQ Channel, and WebSphere MQ Error Log resource models are disabled. For information about the default settings for the resource models, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Table 26 describes the icon, resource type, and icon name for a queue manager object. Channel and queue objects do not hae associated icons. Table 26. IBM Tioli Monitoring for Business Integration: WebSphere MQ queue manager icon Icon Resource type Icon name Queue manager QueueMgrName@hostname Example: M12A@NMPIPL33 where: QueueMgrName Is the name of the queue manager. hostname Is the host name of the computer on which the queue manager resides. For SNA, hostname is the NetView domain name. For a remotely administered queue manager, hostname is the host name of the source queue manager. The queue manager icon reflects the status of the queue manager as described in Table 27. Table 27. IBM Tioli Monitoring for Business Integration: WebSphere MQ icon status Icon state Description A queue manager icon with a green circle containing a right arrow ( ) in the lower right corner indicates that the queue manager is actie or running. A queue manager icon with a yellow diamond containing a question mark (?) in the lower right corner indicates that the status of the queue manager is unknown. A queue manager icon with a red circle containing a minus sign ( ) in the lower right corner indicates that the queue manager is inactie or not running. Chapter 10. Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ 177

202 Table 27. IBM Tioli Monitoring for Business Integration: WebSphere MQ icon status (continued) Icon state Description A queue manager icon with a yellow triangle containing an exclamation point (!) in the lower right corner indicates a warning. A queue manager icon with a red triangle containing an exclamation point (!) in the lower right corner indicates a critical status. Required authorization roles MQS_senior or MQS_domain_name_senior admin Before you begin To discoer queue managers on proxy mode z/os when your task serer is running on a UNIX machine, you must create the WebSphere MQ mqm user ID in the mqm group, if it does not already exist. When your task serer is running on a Windows machine, you must create the WebSphere MQ MUSR_MQADMIN user ID on the task serer machine, if it does not already exist. You must also ensure that the MUSR_MQADMIN user ID can log on locally. To do this, do one of the following: For Windows NT: 1. From the Start menu, click Programs Administratie Tools User Manager. 2. From the Policies menu on the User Manager window, click User Rights. 3. From the User Rights window, click Log on locally from the Right drop-down list. 4. Ensure that MUSR_MQADMIN or its associated group is listed in the Grant To field. For Windows 2000: 1. From the Start menu, click Programs Administratie Tools Local Security Policy. 2. From the Local Policies menu, click User Rights Assignment. 3. Double-click Log on locally in the right pane. 4. Click Add. 5. Double-click MUSR_MQADMIN and click OK. When you finish For each queue manager that is created, an object is created in the Tioli database and an icon is placed in the management domain. Procedure You can create queue manager objects in the following ways: Automatically discoer your existing queue managers. This method is the easiest way to create objects for a large number of existing queue managers. You can run the discoery function immediately or you can schedule the discoery function to run one or more times later. To run the discoery function immediately, follow these steps: 178 IBM Tioli Monitoring for Business Integration: User s Guide

203 1. From the Monitoring for WebSphere MQ policy region, right-click the appropriate management domain icon and click Discoer Queue Managers from the icon context menu to open the Discoer Queue Managers window. 2. Complete the fields, referring to the online help or the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide for additional information. For information about managing WebSphere MQ resources on multiple proxy mode z/os systems, see Managing WebSphere MQ on multiple proxy mode z/os systems on page Click Set and Execute to discoer the queue managers. Additional information: Depending on your enironment, the Discoer Queue Managers task can take oer 15 minutes to complete. To schedule the discoery function to run one or more times later, follow these steps: 1. From the Monitoring for WebSphere MQ policy region, open the appropriate management region and then open the domain_name_mqseries Tasks library. 2. Open the domain_name_queue Mgr Tasks task library. 3. Double-click the domain_name_discoer_queue_mgrs task. 4. Click Execute. 5. Choose the discoery options and endpoints from the dialog. These options are used when discoery is run from the scheduler. 6. Click Sae to open the command window. 7. Type the name of the job you are creating. Additional information: Remember the Identifier Name displayed in the dialog, for example, domain_name_discoer_queue_mgrs_xxx. 8. Click Sae & Close. 9. Click Cancel to create a new task with the Identifier Name. 10. Click Close from the Execute Task Dialog. 11. Select Create Job. 12. Type the name of the job you are creating. 13. Select the Identifier name from the dialog from Set the Timeout alue to at least Click Display on Desktop. 16. Moe the TMR for which you want to create the job from the Aailable Task Endpoints list, to the Selected Task Endpoints list. 17. Click Create & Close. 18. Drag the new job onto the Scheduler icon on the desktop. 19. Complete the date and time that you want this task to run. 20. Click Schedule Job & Close. Run the Create Queue Manager task. Use this method to create a new WebSphere MQ queue manager and a queue manager object. To run the Create Queue Manager task, follow these steps: 1. Open the Monitoring for WebSphere MQ policy region. 2. Right-click the appropriate management domain icon and select Create Queue Manager from the management domain icon context menu. 3. Complete the Create Queue Manager task window, referring to the online help or the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide for additional information. Chapter 10. Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ 179

204 Note: The name of the queue manager you create must be unique throughout your network. Run the Create Queue Manager Icon task. This method is an alternatie to discoering your existing queue managers and is required for remotely administered queue managers. For information about remote administration, see Enabling remote administration for WebSphere MQ on page 142. To run the Create Queue Manager Icon task, follow these steps: 1. Open the Monitoring for WebSphere MQ policy region. 2. Right-click the appropriate management domain icon and select Create Queue Manager Icon from the management domain icon context menu. 3. Complete the Create Queue Manager Icon task window, referring to the online help or the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide for additional information. For each queue manager that is discoered or created, IBM Tioli Monitoring for Business Integration: WebSphere MQ creates an object in the Tioli database and an icon for the queue manager in the management domain region. Note: If you want to delete an endpoint, you must also delete the queue manager icon first and then run the Discoer Queue Managers or the Create Queue Manager Icon task again. 180 IBM Tioli Monitoring for Business Integration: User s Guide

205 Chapter 11. Installing WebSphere MQ software This chapter describes how to create WebSphere MQ software packages to install or upgrade WebSphere MQ software on AIX, HP-UX, Solaris, and Windows endpoints. This chapter also describes how to distribute the WebSphere MQ software package and how to erify the installation of WebSphere MQ on endpoints in your network. IBM Tioli Monitoring for Business Integration: WebSphere MQ does not support the following functions: Creating and distributing WebSphere MQ Version or 5.3 software Creating and installing a WebSphere MQ software package on an OS/400 or a Linux system For more information about software packages, refer to the Tioli Software Distribution User s Guide. Table 28 shows the tasks required to install WebSphere MQ software. Table 28. Installing WebSphere MQ software tasks Goal Where to find procedures 1. Create a WebSphere MQ software package. Creating a WebSphere MQ software package 2. Distribute WebSphere MQ software. Distributing WebSphere MQ software on page Verify the Installation of WebSphere MQ. Verifying the installation of WebSphere MQ software on page 183 Creating a WebSphere MQ software package Objectie To create a WebSphere MQ software package so you can distribute and install WebSphere MQ on Tioli endpoints. Background information The WebSphere MQ software package is created in the MQS_domain_name Install Packs profile manager. Required authorization roles MQS_senior or MQS_domain_name_senior senior Before you begin Tioli Software Distribution must be installed. If you installed Tioli Software Distribution after creating the management domain, you must manually create the MQS_domain_name Install Packs profile manager. To do this, follow these steps: 1. Open the appropriate management domain policy region. 2. From the management domain policy region window, click ProfileManager from the Create menu. Copyright IBM Corp

206 3. Complete the Create Profile Manager window as follows: a. Enter MQS_domain_name Install Packs in the Name/Icon Label field. b. Check the Dataless Endpoint Mode box. 4. Click Create & Close. 5. From the management domain policy region window, click Managed Resources from the Properties menu. 6. Moe SoftwarePackage from the Aailable Resources list to the Current Resources list. 7. Click Set & Close. When you finish The WebSphere MQ software package is created in the MQS_domain_name Install Packs profile manager. Distribute the software package as described in Distributing WebSphere MQ software. Procedure You can perform this procedure from the Tioli desktop only. 1. Run one of the following tasks to create a software package for the operating system of the endpoints to which you want to distribute WebSphere MQ. These tasks are located in the Install Tasks task library in the MQSeries Tasks policy region within the appropriate management domain. Create AIX File Pack Create HP-UX File Pack Create Solaris File Pack Create Windows File Pack 2. Complete the task window, referring to the online help or the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide for additional information. 3. Click Set and Execute to create the software package. Distributing WebSphere MQ software Objectie To distribute and install WebSphere MQ software. Background information On Windows platforms, you must install all prerequisite products before you distribute the WebSphere MQ software. You must also reboot Windows endpoints after installing WebSphere MQ. For more information about the prerequisites for WebSphere MQ, refer to the WebSphere MQ product documentation. If you distribute the WebSphere MQ product for Windows platforms from a CD-ROM that is mounted on an HP computer, you might need to correct file naming and case problems. For example, the setup.exe file might appear as setup.exe;1. The directory structure might appear entirely uppercase. For more information on correcting these problems, refer to the pfsd, pfs_mount, and pfsd commands in the HP operating system documentation. Required authorization roles admin Before you begin Not applicable. 182 IBM Tioli Monitoring for Business Integration: User s Guide

207 When you finish Verify the installation of the WebSphere MQ software as described in Verifying the installation of WebSphere MQ software. You must also reboot Windows endpoints after installing WebSphere MQ. Procedure 1. Open the Monitoring for WebSphere MQ policy region. 2. Open the appropriate management domain policy region. 3. Open the MQS_domain_name Install Packs profile manager and subscribe the appropriate Tioli endpoints to the profile manager. 4. Distribute the software package. For more information about distributing software packages, refer to the Tioli Software Distribution User s Guide. Note: On a Windows system, initial distribution of a WebSphere MQ software package to an endpoint can fail because bash is a dependency. If this happens, you receie messages similar to the following in the Tioli Software Distribution trace file: Operation unsuccessful. Execution of user program /tmp/mqs/mqs_create_fp_pre.sh failed Run the Initialize_Endpoints task (MQS Utility Tasks task library) on the appropriate endpoint to push the dependency set code to the endpoint een though WebSphere MQ is not installed on the endpoint. Then, distribute the WebSphere MQ software package. For more information about the Initialize_Endpoints task, see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Verifying the installation of WebSphere MQ software Objectie To erify the installation of the WebSphere MQ software. Background information This procedure checks the ability to create, start, and stop a queue manager. Required authorization roles MQS_admin or MQS_domain_name_admin admin Before you begin Distribute and install WebSphere MQ software as described in Distributing WebSphere MQ software on page 182. When you finish Not applicable. Procedure To erify the installation, complete the following steps. The sequence of steps might ary if the queue manager is already created or started. 1. Open the Monitoring for WebSphere MQ policy region. 2. Create a test queue manager on an endpoint to which you hae distributed the WebSphere MQ software. Right-click the appropriate management domain icon and select Create Queue Manager from the icon context menu. Complete the Chapter 11. Installing WebSphere MQ software 183

208 task window, referring to the online help or the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide if you need additional information. Ensure that you check the Start box to start the test queue manager. 3. Stop the test queue manager. Right-click the queue manager icon and select Queue Manager Tasks Control Queue Manager Stop. 4. Optionally, delete the test queue manager. Right-click the queue manager icon and select Queue Manager Tasks Delete Queue Manager. 184 IBM Tioli Monitoring for Business Integration: User s Guide

209 Chapter 12. Managing WebSphere MQ proxy mode z/os SMF records IBM Tioli Monitoring for Business Integration: WebSphere MQ for proxy mode z/os proides the Statistics Eent Adapter to enable you to manage WebSphere MQ proxy mode z/os System Management Facilities (SMF) statistics and accounting records. This chapter describes how the Statistics Eent Adapter works, how to start the Statistics Eent Adapter, and how to control the number of eents that it sends to the eent console. For information about setting up the Statistics Eent Adapter, refer to the IBM Tioli Monitoring for Business Integration Installation and Setup Guide. For more information about SMF statistics and accounting records, refer to the MQSeries for OS/390 V5.2 Interpreting accounting and statistics data support pack, MP1B on the following Web site: Table 29 shows the tasks you can use to manage WebSphere MQ proxy mode z/os SMF records. Table 29. Managing WebSphere MQ proxy mode z/os SMF records Goal Where to find procedures 1. Start the Statistics Eent Adapter. Starting the Statistics Eent Adapter on page Control the number of statistics eents receied at the eent console. Controlling statistics eents on page 187 Understanding how the Statistics Eent Adapter works The Statistics Eent Adapter reads WebSphere MQ SMF statistics and accounting records (115 and 116, respectiely), reformats the data into eent console eents, and sends the formatted eents to the eent serer. The Statistics Eent Adapter runs in burst mode. That is, the Statistics Eent Adapter runs periodically as needed, usually when the SMF data set fills up and is dumped to tape. The Statistics Eent Adapter sends all eents and then stops. At startup, the Statistics Eent Adapter reads a configuration file, TAMQZCFG. The following diagram illustrates how the Statistics Eent Adapter retriees WebSphere MQ SMF records and sends them as formatted eents to the eent serer: Copyright IBM Corp

210 Figure 25. How the Statistics Eent Adapter works Starting the Statistics Eent Adapter Objectie To start the Statistics Eent Adapter as needed to process the SMF records in the alternate data set. Background information See Understanding how the Statistics Eent Adapter works on page 185. Before you begin Not applicable. When you finish Not applicable. Procedure The Statistics Eent Adapter can be started automatically or manually. If you hae configured the SMF dump JCL to replace the SMF records in the alternate data set each time the SMF dump is run, start the Statistics Eent Adapter automatically to ensure that you do not lose any SMF records. To do this, add the SMF IHSMTECZ JCL as a job step to the SMF Dump JCL. To start the Statistics Eent Adapter manually, start the IHSMTECZ job at the proxy mode z/os operator s console after the SMF dump job completes. 186 IBM Tioli Monitoring for Business Integration: User s Guide

211 Controlling statistics eents Objectie To minimize the number of statistics eents receied at the eent console. Background information See Understanding how the Statistics Eent Adapter works on page 185 Before you begin Not applicable. When you finish Not applicable. Procedure Tracing SMF records can produce a large amount of trace data. To minimize the number of statistics eents receied at the eent console, consider doing the following: Dump the SMF records and run the Statistics Eent Adapter at least once a day. Limit the SMF data that is traced using the START TRACE command as follows: Consider tracing either statistics or accounting data instead of tracing both types of data. Limit tracing to specific queue managers. Use WebSphere MQ constraints. For more information about the START TRACE command, refer to the WebSphere MQ product documentation. Specify that the eent is not to be forwarded to the eent serer. In this case, you specify filter criteria in the Statistics Eent Adapter configuration file. For more information, refer to the information about setting up the Statistics Eent Adapter in the IBM Tioli Monitoring for Business Integration Installation and Setup Guide. Create new rules to exclude the eent. In this case, the eent is forwarded to the eent serer, but it is eliminated by the rules engine. For more information, refer to the IBM Tioli Enterprise Console Rule Builder s Guide. You can create one eent console to display the statistics eents and another eent console to display accounting eents. Chapter 12. Managing WebSphere MQ proxy mode z/os SMF records 187

212 188 IBM Tioli Monitoring for Business Integration: User s Guide

213 Chapter 13. Managing messages with IBM Tioli Monitoring for Business Integration: WebSphere MQ Message Manager This chapter describes how to configure and use the IBM Tioli Monitoring for Business Integration: WebSphere MQ Message Manager, hereinafter referred to as the Message Manager. The Message Manager is a Jaa application implemented as a WebSphere MQ client. You can use the application to manage messages through a console on a queue. You perform the following tasks: Browse a message Copy a message to another queue Delete a message Export data into a file from a message Import data from a file into a message Moe a message to another queue Table 30 proides a list of goals for working with the Message Manager Console. The table also tells where to locate information about the procedures for each goal. Table 30. Setting up and using Message Manager Goal Launch the Message Manager. Where to find procedures Launching Message Manager Obtain help for using Message Manager. Using Message Manager help on page 192 Use the Message Manager console to manage messages receied by IBM Tioli Monitoring for Business Integration: WebSphere MQ. Browsing messages on page 193 Copying and Moing messages on page 194 Deleting Messages on page 195 Importing data from a file to a message on page 195 Launching Message Manager Objectie To launch the Message Manager. Background information You can launch the Message Manager to open a tree iew of aailable queue managers with menus and property lists that you can edit. The Message Manager console contains a title bar, a menu bar, a tool bar, a status bar, a workspace (tree iew), and a work area. Copyright IBM Corp

214 Figure 26. Message Manager console Required authorization role Not applicable Before you begin Install the Message Manager, as described in Installing and Uninstalling Message Manager in IBM Tioli Monitoring for Business Integration Installation and Setup Guide. Select one of the two preferred display types: Display type from your preious Message Manager session Message Manager with information on specific queue managers Note: You must launch the Message Manager from the directory in which you installed the Message Manager software. When you finish Use Message Manager to manage messages using tasks such as the following: Browse a message Copy a message to another queue Delete a message Export data into a file from a message Import data from a file into a message Moe a message to another queue 190 IBM Tioli Monitoring for Business Integration: User s Guide

215 OR Stop the Message Manager by clicking Console Exit on the Message Manager. Procedure You must perform this procedure from the command line. Use the command for the type of display you want to launch: Display type from your preious Message Manager session mm4wmq If you start Message Manager using the mm4wmq command without parameters, the Message Manager starts with the same display used in your preious session. Message Manager with information on specific queue managers mm4wmq m qmgrname h hostname [ p port] where: m qmgrname Specifies the name of the queue manager to which Message Manager connects when you launch the Message Manager console. Specifying the name of the queue manager is optional. h hostname Specifies the TCP/IP host name of the machine where the queue manager resides. You can specify a simple host name, such as myhost, or a fully-qualified host name, such as myhost@ibm.com, or an IP address, such as p port Specifies the port number that the channel listener for the queue manager is using. Specifying the port number is optional. If you do not specify a port number, the default port number is 1414 as shown in the Add Definition window. Chapter 13. Managing messages with IBM Tioli Monitoring for Business Integration: WebSphere MQ Message Manager 191

216 Using Message Manager help Figure 27. Add Definition window in Message Manager You can also specify the following options when using the mm4wmq command: d qmgrname Specifies the name of the queue manager that Message Manager connects to when you launch the Message Manager console. Specifying the name of the queue manager is optional. f cfg_file Specifies the name of the file that contains a list of queue manager names for the queues you want to manage. Specify each queue manager name on a separate line in the file in the following format: qmgrname:host:port F Starts Message Manager without displaying queue manager names. Objectie To access and naigate online help in the Task Assistant for the Message Manager. Background information Message Manager uses the Task Assistant to display helpful information. The Task Assistant is an online reference tool that proides information about the actie Message Manager window and procedures to follow. The Open, Sae, and Sae As functions work with configuration files associated with each. The Task Assistant contains panel-leel and context-sensitie help. The procedures for using the Message Manager are outlined in the Task Assistant. 192 IBM Tioli Monitoring for Business Integration: User s Guide

217 The Task Assistant tool bar proides icons that enable quick access to the following functions: Preious Topic Next Topic Table of Contents Topic Index Message Index Search Browsing messages Print Topic Required authorization role Not applicable. Before you begin Launch the Message Manager console, as described in Launching Message Manager on page 189. When you finish Not applicable Procedure 1. Use one of the following methods to open the Task Assistant: Click the question mark (?) in the upper right corner of a Message Manager window. Select one of the following options from the Help menu: Open Task Assistant opens the Task Assistant. If the Task Assistant is currently open, this option closes the Task Assistant. Table of Contents opens the Task Assistant table of contents. Index opens the Task Assistant topics. Search opens the Task Assistant Find function. Press F1. 2. (Optional) Access descriptions of messages related to the operation of Message Manager as follows: Click the Message Index icon in the Task Assistant. Click the number of the message. Additional information: Messages for Message Manager hae the CTQ prefix. Objectie To browse the contents of a message by iewing the message text displayed. Background information The message iew contains the contents of a message descriptor, in notebook style, with the following tabs to display the type of message data: General Context Identifiers Segmentations Report Message data Chapter 13. Managing messages with IBM Tioli Monitoring for Business Integration: WebSphere MQ Message Manager 193

218 The message data page displays a maximum of 32 KB of message data. Required authorization role Not applicable. Before you begin Launch the Message Manager console, as described in Launching Message Manager on page 189. When you finish Not applicable. Procedure 1. Perform one of the following steps to browse a message: Double-click on a message in the Queue iew. Select a message in the Queue iew, right-click on the message, and then select Properties from the Context menu. Select a message in the Queue iew, right-click on the message, and then select Properties from the Action menu. 2. View the message text and then close. Copying and Moing messages Objectie To copy or moe a message to another queue manager. Background information When copying a message segment, ensure that you copy all other messages that belong to the same logical group. Required authorization role Not applicable. Before you begin Launch the Message Manager console, as described in Launching Message Manager on page 189. When you finish Not applicable. Procedure Perform the following steps to copy or moe a message to another queue manager. 1. Right-click on a message in the Queue iew and select Copy or Moe from the Context menu. 2. Select Copy from the Edit pull-down menu. 3. In the naigation area, select the queue manager name to where you want to copy or moe the message. 4. Right-click the selected queue manager name. 5. Click Edit Paste. 6. An additional copy of the selected message is now contained in the selected queue manager, or the selected message is moed to the queue manager selected. 194 IBM Tioli Monitoring for Business Integration: User s Guide

219 Deleting Messages Objectie To delete a message from a queue manager. Background information For completed or insignificant messages, you can delete selected messages from selected queue managers. To delete an entire queue managers definition, see the procedures outlined in the Message Manager Task Assistant. Required authorization role Not applicable. Before you begin Launch the Message Manager console, as described in Launching Message Manager on page 189. When you finish Not applicable. Procedure Perform the following steps to delete a message from a queue manager: 1. Click on a message in the Queue iew to select the message to delete. 2. Right-click on the message and select Delete from the Context menu OR Click Edit Delete from the pull-down menu. 3. Click Yes in the Delete Confirmation window. Importing data from a file to a message Objectie To import data from a file to a message. Background information You can import data from a file to an existing message file. Required authorization role Not applicable. Before you begin Launch the Message Manager console, as described in Launching Message Manager on page 189. When you finish Not applicable. Procedure Perform the following steps: 1. Select a message in the Queue View. 2. Double-click the message to display the message contents. 3. Click the Message Data tab in the Message View. Chapter 13. Managing messages with IBM Tioli Monitoring for Business Integration: WebSphere MQ Message Manager 195

220 Figure 28. Message View window with Message Data option highlighted 4. Click Import Message Data to open the Import Message Data window. 5. Naigate to a directory of your choice and click the name of the file containing the data that you want to import into the message. 6. Click Open. 7. Click Sae message to queue and close in the Message View. 8. Click Yes in the Retain window to sae the original message and the imported ersion. OR Click No to replace the original message with the imported ersion and not sae the original. Exporting data from a message to a file Objectie To export data from a message to a file. Background information You can export data from a message to a selected file. Required authorization role Not applicable. 196 IBM Tioli Monitoring for Business Integration: User s Guide

221 Before you begin Launch the Message Manager console, as described in Launching Message Manager on page 189. When you finish Not applicable. Procedure Perform the following steps: 1. Select a message in the Queue View. 2. Double-click the message to display the message contents. 3. Click the Message Data tab in the Message View. 4. Click Export Message Data to open the Export Message Data window. 5. Click the message you want to export to a file. Chapter 13. Managing messages with IBM Tioli Monitoring for Business Integration: WebSphere MQ Message Manager 197

222 198 IBM Tioli Monitoring for Business Integration: User s Guide

223 Chapter 14. Working with Workflow serers and queue managers This chapter describes how to work with Workflow serers and queue managers. Table 31 shows the goals you can achiee and where to find the procedures for each goal. Table 31. Working with Workflow serers and queue managers Goal Where to find procedures 1. Access Workflow tasks for a queue manager. Accessing Workflow tasks on page Assign authorization. Setting authorization roles on page Start and stop Workflow Administration serers. Setting the ADMIN password on page 206 Starting the Workflow Admin Serice on page 207 Stopping the Workflow Admin Serice on page Check the status of Workflow serices. Using the Workflow Serices window on page Check the configuration of Workflow serices Checking the Workflow Configuration on page Start and stop selected Workflow serices. Starting selected Workflow serices on page Work with Workflow resource models: Distribute resource models. Stop resource models from monitoring. Stopping selected Workflow serices on page 211 Enabling monitoring on page 212 Disabling monitoring on page 213 Workflow oeriew Workflow serer components, also referred to as Workflow serices, coordinate and manage MQ Workflow systems and clients. Workflow serices are also responsible for tracking and administering the execution of processes. The Workflow serices component proides the following features: Resource model that monitors the state of WebSphere MQ Workflow serices, including Administration, Cleanup, and Scheduling Resource model that monitors the state of WebSphere MQ Workflow processes Listener and trigger monitor serices Open Workflow Serices task that you use to stop and start serices and to enable and disable monitoring Copyright IBM Corp

224 IBM Tioli Monitoring task that restarts Workflow serices in the eent of a failure IBM Tioli Monitoring task that starts another copy of the Execution Serer if a backlog is detected. Check Workflow Configuration task that you use to modify your Workflow configuration Support for the IBM Tioli Enterprise Data Warehouse product See the IBM Tioli Monitoring for Business Integration: MQ Workflow Warehouse Enablement Pack Implementation Guide. For Workflow serices, the Execution Serer is responsible for the execution of Workflow processes. For example, if a process contains actiities for automatic execution, the Execution Serer automatically performs specific actiities at specific times or forwards work items to a specified person at a predefined time if human interention is required. The Execution Serer performs the following actions: Interprets process definitions, such as process definitions for the flow of work related to staff, programs, and data Creates process instances and manages the execution of the processes, such as starting, stopping, and suspending Naigates between different work actiities and creates work items required for processing each actiity Manages process states and logs releant eents Maintains work lists of Runtime users You manage the following Workflow and MQ serices: Administration Serer The Administration Serer manages MQ Workflow systems and communicates with all other components in a system or system group. The Administration Serer is the working center of the administration component and is responsible for system aailability, operation, and error recoery of all serer components. Cleanup Serer The Cleanup Serer is responsible for deleting process instances that are complete. Completed processes are deleted immediately, or you can set definitions to delete the completed processes later in the day when the system is idle. Execution Serer The Execution Serer maintains information about the states of all actiities in the MQ Workflow Runtime database. The Execution Serers acts as a database client, using communication mechanisms aailable with the base database management system, to communicate with the Database Serer. Listener The listener is a continuously running script that monitors incoming network connections. Scheduling Serer The Scheduling Serer controls and manages notifications for actiities that are defined to be performed at a specific time or within a time frame. If work items are oerdue for a process, the Scheduling Serer changes the 200 IBM Tioli Monitoring for Business Integration: User s Guide

225 Accessing Workflow tasks state of the work item to EXPIRED. The Scheduling Serer can also send notifications to actiities that require action to the releant person. Trigger monitor The trigger monitor is an application that runs continuously and seres one or more initiation queues. For example, in a work item initiation queue, the trigger monitor retriees messages. It then uses the information retrieed to start processes defined for sering the queue on which the trigger eent occurred. You can also monitor specific Workflow serices processes. Each Workflow process is controlled by the Workflow client. In a Tioli management enironment, the policy region can only be accessed using the desktop naigator function. The profile manager that contains the resource models is used as the default for monitoring, or you can add or customize existing resource models. Objectie To display a menu for the Workflow serices tasks for a queue manager. Background information When you hae the Workflow serer component installed with IBM Tioli Monitoring for Business Integration: WebSphere MQ, you can run Workflow tasks from a queue manager icon context menu or from the Queue Manager Control Center window for a management domain. You can access the following tasks from the queue manager icon context menu: Open Workflow Serices Check Workflow Configuration Start Workflow Admin Serice Stop Workflow Admin Serice Enter ADMIN Password Set Queue Manager Authorizations You can access the following Workflow tasks from the Queue Manager Control Center window: Check Workflow Configuration Start Workflow Admin Serice Stop Workflow Admin Serice Set Queue Manager Authorizations After running a task, a task output window opens. Required authorization role mqwf_admin Before you begin Access the Tioli desktop as described in Accessing the Tioli Management Framework enironment on page 32. When you finish Run a Workflow task depending on which menu you accessed. See Background information for a list of the tasks on each menu. Chapter 14. Working with Workflow serers and queue managers 201

226 Procedure You can perform this procedure from the desktop using an icon context menu or the Queue Manager Control Center window. Icon context menu: 1. Open the Policy Region: Monitoring for WebSphere MQ window by double-clicking the Monitoring for WebSphere MQ icon on the Tioli desktop. Figure 29. Policy Region: Monitoring for WebSphere MQ window 2. Double-click the MQWF Resource Models icon to open the Profile Manager window for the MQWF Resource Models. 202 IBM Tioli Monitoring for Business Integration: User s Guide

227 Figure 30. Profile Manager window for MQWF Resource Models 3. Right-click a queue manager icon in the Subscribers area of the Profile Manager window to open the queue manager icon context menu. Chapter 14. Working with Workflow serers and queue managers 203

228 Figure 31. Queue manager icon context menu 4. Click MQWF Tasks to open the menu of Workflow tasks. 204 IBM Tioli Monitoring for Business Integration: User s Guide

229 Figure 32. Queue Manager icon context menu of Workflow tasks Queue Manager Control Center window: For information about running a task from the Queue Manager Control Center window, see Queue Manager Control Center window on page 149. Figure 33 on page 206 shows the menus for Workflow that are aailable from the Queue Manager Control Center window. Chapter 14. Working with Workflow serers and queue managers 205

230 Figure 33. Workflow menus aailable from the Queue Manager Control Center window Setting the ADMIN password Objectie To set the ADMIN password so you can use Workflow serices tasks and resource models. 206 IBM Tioli Monitoring for Business Integration: User s Guide

231 Background information The ADMIN password is required to perform the following actions: Connect to the Workflow serers Check to ensure the admin serer is running Use the Workflow Process resource model Stop the admin serer The ADMIN password is set from the queue manager icon and is encrypted as the context ariable MQWF_PASSWD. Required authorization role mqwf_admin Before you begin Access the menu of Workflow tasks from a queue manager icon. When you finish Verify the ADMIN password using the following procedure: Starting the Workflow Admin Serice. Procedure You can perform this procedure from the desktop. 1. Click Enter ADMIN Password from the menu of Workflow tasks to open the Enter ADMIN Password window. Figure 34. Enter ADMIN Password window 2. Type the password for the Workflow ADMIN user to sae it in the object for use when performing actions for tasks and resource models. Additional information: The Set MQ Authorization task is used when the tmemqs_user is not authorized to access the Workflow queue manager. 3. Click Set. 4. Access the menu of Workflow tasks as described in Accessing Workflow tasks on page Click Set Queue Manager Authorizations. 6. Click Close after reiewing the output window. 7. Repeat Steps 1 3 to set additional ADMIN passwords for each Workflow serer in your enironment. Starting the Workflow Admin Serice Objectie To start the Administration Serer that manages your MQ Workflow system. Chapter 14. Working with Workflow serers and queue managers 207

232 Background information The Workflow Admin Serice is the Administration Serer that manages an MQ Workflow system. It is the working center of the administration component and communicates with all other components in a system or system group. The Administration Serer is responsible for the aailability, operation, and error recoery of all serer components. Required authorization role mqwf_admin Before you begin You must set the ADMIN password. Access the menu of Workflow tasks from a queue manager. When you finish Not applicable. Procedure You can perform this procedure from the desktop using an icon context menu or a Queue Manager Control Center window. Icon context menu: Initiate this task from a queue manager icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Queue Manager Control Center window: For information about running a task from the Queue Manager Control Center window, see Queue Manager Control Center window on page 149. For more information about the Start Workflow Admin Serice task, see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Stopping the Workflow Admin Serice Objectie To stop the Administration Serer that manages your MQ Workflow system. Background information The Workflow Admin Serice is the Administration Serer that manages an MQ Workflow system. It is the working center of the administration component and communicates with all other components in a system or system group. The Administration Serer is responsible for the aailability, operation, and error recoery of all serer components. Required authorization role mqwf_admin Before you begin You must hae an ADMIN password. Access the menu of Workflow tasks from a queue manager. When you finish Not applicable. 208 IBM Tioli Monitoring for Business Integration: User s Guide

233 Procedure You can perform this procedure from the desktop using the icon context menu or a Queue Manager Control Center window. Icon context menu: Initiate this task from a queue manager icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Queue Manager Control Center window: For information about running a task from the Queue Manager Control Center window, see Queue Manager Control Center window on page 149. For more information about the Stop Workflow Admin Serice task, see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Using the Workflow Serices window Objectie To display the status of each Workflow serice so you can take actions on a selected serice. Background information When you display the Workflow Serices window, you can see the status of each Workflow serice. Also, you can use the Action menu in this window to take the following actions on a serice. Start a selected Workflow serice Stop a selected Workflow serice Enable resource model monitoring Disable resource model monitoring Refresh the status of selected Workflow serices The Display Workflow Serices task cannot be used when selecting multiple tasks from the Queue Manager Control Center window. Required authorization role mqwf_admin Before you begin You must hae an ADMIN password. Access the menu of Workflow tasks from a queue manager. When you finish You can perform one of the following actions on one of the serices in the WorkFlow Serices list of the Workflow Serices window: Stopping the Workflow Admin Serice on page 208 Starting the Workflow Admin Serice on page 207 Enabling monitoring on page 212 Disabling monitoring on page 213 Procedure You can perform this procedure from the desktop. Chapter 14. Working with Workflow serers and queue managers 209

234 1. Click Open Workflow Serices to open the Workflow Serices window. Figure 35. Workflow Serices window 2. Reiew the information in the Workflow Serices window: Queue Manager Name of the queue manager that is currently running the Workflow administration serer Default Monitor Status Status of the default monitor for the selected Workflow serice: Actie or Inactie. WorkFlow Serices List of Workflow serices and the status of each serice: running or stopped. 3. Click Action Refresh to refresh the status of the serices if you want to check whether the status of a serice has changed since you opened the window. Checking the Workflow Configuration Objectie To check the configuration of Workflow. Background information Not applicable. Required authorization role mqwf_admin Before you begin You must hae an ADMIN password. Access the menu of Workflow tasks from a queue manager. When you finish Not applicable. 210 IBM Tioli Monitoring for Business Integration: User s Guide

235 Procedure You can perform this procedure from the desktop using an icon context menu or the Queue Manager Control Center window. Icon context menu: Initiate this task from a queue manager icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Queue Manager Control Center window: For information about running a task from the Queue Manager Control Center window, see Queue Manager Control Center window on page 149. For more information about the Check Workflow Configuration task, see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Starting selected Workflow serices Objectie To start a specific Workflow serice that is currently stopped. Background information Starting some serices causes other dependent serices to start. For example, starting the scheduling serer also starts the administration serer. Required authorization role mqwf_admin Before you begin You must hae an ADMIN password. Perform the Using the Workflow Serices window on page 209 procedure to open the Workflow Serices window. When you finish Not applicable. Procedure You can perform this procedure from the desktop. 1. Click the serice on which you want to take an action in the WorkFlow Serices list. 2. Click Action Start Serice. 3. Click Close after reiewing the output in the window. Stopping selected Workflow serices Objectie To stop a specific Workflow serice that is currently running. Background information Stopping some serices causes other dependent serices to stop. For example, stopping the administration serer also stops the scheduling serer. Required authorization role mqwf_admin Chapter 14. Working with Workflow serers and queue managers 211

236 Enabling monitoring Before you begin You must hae an ADMIN password. Perform the Using the Workflow Serices window on page 209 procedure to open the Workflow Serices window. When you finish Not applicable. Procedure You can perform this procedure from the desktop. 1. Click the serice on which you want to take an action in the WorkFlow Serices list. 2. Click Action Stop Serice. 3. Click Close after reiewing the output in the window. Objectie To enable the selected resource model to run on the endpoint. Background information You can distribute the MQWF RM profile ia the Enabling Monitoring feature from the Workflow serices panel as well as by right-clicking the profile icon and selecting Distribute.... By default, the MQWF RM profile contains the following two resource models, which are preconfigured and ready for distribution: Workflow Status Monitor Monitors the administration serer, listener and trigger monitor. WebSphere MQ Queue Monitors key workflow queues and starts an additional copy of the execution serer if a backlog of the execution serer queue is detected. For information about resource models, see Chapter 2, Setting up IBM Tioli Monitoring for Business Integration, on page 31 and Resource model concepts on page 49. Required authorization role mqwf_admin Before you begin You must hae an admin password. Perform the Using the Workflow Serices window on page 209 procedure to open the Workflow Serices window. When you finish Not applicable. Procedure You can perform this procedure from the desktop. 1. Click Action Enable Monitoring. 2. Click Close after reiewing the output in the window. 212 IBM Tioli Monitoring for Business Integration: User s Guide

237 Disabling monitoring Objectie To disable the selected resource model from running on the endpoint. Background information For information about resource models, see Chapter 2, Setting up IBM Tioli Monitoring for Business Integration, on page 31 and Resource model concepts on page 49. Required authorization role mqwf_admin Before you begin You must hae an ADMIN password. Perform the Using the Workflow Serices window on page 209 procedure to open the Workflow Serices window. When you finish Not applicable. Procedure You can perform this procedure from the desktop. 1. Click Action Disable Monitoring. 2. Click Close after reiewing the output in the window. Chapter 14. Working with Workflow serers and queue managers 213

238 214 IBM Tioli Monitoring for Business Integration: User s Guide

239 Part 3. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Copyright IBM Corp

240 216 IBM Tioli Monitoring for Business Integration: User s Guide

241 Chapter 15. Quick-reference guide for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator This chapter proides a quick-reference table of the setup procedures you must perform before you can use IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. Table 32 includes cross-references to places where you can find additional information about each of these procedures. Table 32. Quick-reference information for getting started with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Goal Starting 1. Access the Tioli enironment so you can manage and monitor your queue manager enironment. Setting up administrators to use the software 2. Authorize persons to hae the roles they need for managing resources in the product. Note: You must assign both Tioli and WebSphere MQ Integrator authorization roles to administrators in the policy regions that you want them to administer. Setting up managed resources 3. Create or discoer IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects. Where to find procedures Accessing the Tioli Management Framework enironment on page 32 Setting authorization roles on page 33. Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator on page 320 lists the authorization roles required for each procedure. Use the Edit Default Policies window in an IBM Tioli Monitoring profile to set the user and group IDs for the profile. See the Tioli Management Framework User s Guide for information about how to assign authorization roles to Tioli administrators. Creating IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects on page Configure performance monitoring. Configuring performance monitoring on page 221 Setting up monitoring profiles and tasks Installing the Tioli MQSI performance database serice on page 222 Installing the TioliMonitor node on brokers on page 223 Installing the TioliMonitor node on Control Centers on page 223 Inserting and deploying the TioliMonitor node on page Set up and schedule jobs from tasks. Chapter 8, Working with tasks and jobs, on page 141 Also see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide for information about specific tasks. Copyright IBM Corp

242 Table 32. Quick-reference information for getting started with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator (continued) Goal 6. Set up the resource models that you want to run: Set up the suggested resource models and run them for a period of time. Remoe any resource models that are not necessary for your enironment. Where to find procedures Chapter 3, Working with resource models, on page 49. Also see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide for information about specific resource models. 218 IBM Tioli Monitoring for Business Integration: User s Guide

243 Chapter 16. Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator This chapter proides an oeriew of the steps you must complete to configure IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator and proides some important information about using the product. Table 33 lists the steps required to set up IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator, as well as links to where to find information. Table 33. Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Goal 1. Access the interfaces in the Tioli enironment so you can use the operations and functions of IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Where to find procedures Accessing the Tioli Management Framework enironment on page Set authorization roles Setting authorization roles on page Create or discoer IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects 4. Configure performance monitoring 1. Installing the Tioli MQSI performance database serice on page Installing the TioliMonitor node on brokers on page Installing the TioliMonitor node on Control Centers on page Inserting and deploying the TioliMonitor node on page 224 Creating IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects Configuring performance monitoring on page 221 Creating IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects Objectie To create IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects that represent your WebSphere MQ Integrator components. Background information The first step in setting up your enironment to manage WebSphere MQ Integrator resources (brokers, Configuration Managers, and User Name Serers) is to create Tioli objects for each resource that you want to manage. You can do this in one of four ways: Copyright IBM Corp

244 Table 34. Methods to create Tioli objects for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Method Discoer task Tioli desktop with the GUI Create option CLI command Create tasks Description Creates objects to represent existing WebSphere MQ Integrator components Creates objects to represent existing WebSphere MQ Integrator components Creates objects to represent existing WebSphere MQ Integrator components Creates both WebSphere MQ Integrator components and the Tioli objects that represent them. The object is added as a subscriber to the WMQI Components profile manager. If the object is a broker, it is also added as a subscriber to the WMQI Brokers profile manager. If you hae classic Tioli Distributed Monitoring 3.7, objects are also subscribed to the MQSI Components profile manager; brokers are also subscribed to the MQSI Brokers profile manager. Tioli objects for WebSphere MQ Integrator components that reside on Tioli endpoints, by default, are created on the managed node that hosts the Tioli endpoint s current gateway. You cannot moe the objects after they are created. If the managed node hosting a Tioli endpoint s gateway fails, you must take recoery action. If possible, restore the managed node from a backup. If you cannot restore the managed node, you must delete the Tioli objects for the affected Tioli endpoints and then recreate the Tioli objects. If you want to control where the objects are located, create the objects by one of these methods: From the desktop GUI Create option The window that opens when you create an object from the desktop enables you to specify the managed node on which you want to create the object. Using the CLI create commands The m option enables you to enter the name of the managed node on which you want to create the object. See the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide for more information. You cannot specify where to create an object when you run the Discoer task or the create tasks in the MQSI Operational Tasks task library. Required authorization role mqsi_senior Before you begin Assign authorizations roles to administrators. See Setting authorization roles on page 33 for more information. When you finish Distribute the monitoring profiles. See Distributing profiles on page 43 for more information. 220 IBM Tioli Monitoring for Business Integration: User s Guide

245 Procedure You can create objects from the command line, through a task, or from the Tioli desktop. Command Line: Run the appropriate IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator CLI command to create the appropriate objects (MQSIBroker, MQSIConfigMgr, and MQSIUsrNameSr) for existing WebSphere MQ Integrator components (brokers, Configuration Managers, and User Name Serers). Desktop: Follow these steps to perform this procedure from the Tioli desktop: 1. From a policy region that has MQSI classes defined as managed resources (such as the Monitoring for WMQI policy region), click Create. 2. Click the type of object that you want to create: MQSIBroker, MQSIConfigMgr, or MQSIUsrNameSr. 3. Complete the fields on the window to configure the new object you are creating. Click Help for a description of each field. When you create objects from the desktop, IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator alidates some of the parameters you specified on the window. If the alidation succeeds, the object is created. The WebSphere MQ Integrator component is not created and must already exist. If the alidation fails, the object is not created and an error message is displayed. Task: To discoer and automatically create a Tioli object for each WebSphere MQ Integrator object, run the Discoer task on your WebSphere MQ Integrator systems. The Discoer task creates an object in Tioli for each existing WebSphere MQ Integrator component found on the systems and creates the appropriate icon for it on the desktop. For information on how to use this task, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide. To create a WebSphere MQ Integrator component and an associated Tioli object, use one of the create tasks (Create Broker, Create Configuration Manager, or Create User Name Serer). For more information on tasks, see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide. Configuring performance monitoring Performance monitoring proides information about message traffic through a message flow. Message flow information is obtained by including the TioliMonitor in a WebSphere MQ Integrator message flow. The TioliMonitor node is a node that has one input and one output terminal. As messages pass through the node, statistics are recorded for that message. Multiple nodes can be used in a message flow to monitor both performance of execution paths as well as error paths. These statistics are sent to a central Tioli MQSI Performance Database serer where they are collected. The Message Flow Performance resource model is proided to monitor these statistics. Chapter 16. Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator 221

246 Using the TioliMonitor node requires that you perform the following actiities: Table 35. Guidelines for setting up performance monitoring for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Goal Install the Tioli MQSI Performance Database Serice to act as a central serer to receie, store, and report node statistics Install the TioliMonitor node on your brokers Install the TioliMonitor node on Control Centers Insert and configure the TioliMonitor node in one or more message flows, and deploy the message flows Define and deploy the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator performance resource model. Where to find procedures Installing the Tioli MQSI performance database serice Installing the TioliMonitor node on brokers on page 223 Installing the TioliMonitor node on Control Centers on page 223 Inserting and deploying the TioliMonitor node on page 224 See Chapter 3, Working with resource models, on page 49 for more information. Installing the Tioli MQSI performance database serice Objectie To install the Tioli MQSI performance database serice. Background information The Tioli MQSI Performance Database Serice (Tioli MQSI PerfDB Serice) is the central serer facility used to record and report node statistics. This facility must be installed in order to use the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator performance monitoring tools. This facility runs only on Windows NT and Windows 2000 platforms, but it supports TioliMonitor reporting from all supported platforms. Each installation of this serice can support reporting from a maximum of 2000 TioliMonitor node instances. The serice collects information from the TioliMonitor node instances using UDP connections. When installing the serice, you must proide the port number for the serice to use for receiing information from the TioliMonitor instances. Required authorization role mqsi_senior Before you begin Determine the UDP port that the PerfDB serice will use to communicate with the TioliMonitor nodes. When you finish The Windows endpoint on which you installed the PerfDB serice is subscribed to the WMQI PerfDB Resource Model profile manager. If you hae classic Tioli Distributed Monitoring 3.7 installed, the endpoint is subscribed to the MQSI PerfDB monitoring profile manager. Procedure To install the PerfDB serice, run the Install PerfDB Task on a Windows endpoint. For information on running this task, see the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide. 222 IBM Tioli Monitoring for Business Integration: User s Guide

247 Installing the TioliMonitor node on brokers Objectie To install the TioliMonitor node.lil file on a broker. Background information The TioliMonitor node is supported for only distributed platforms. Install the TioliMonitor node.lil file on all brokers with message flows that use the TioliMonitor node. If you deploy a message flow that uses the TioliMonitor node on a broker without the.lil file, the TioliMonitor node does not function. Required authorization role mqsi_senior Before you begin Not applicable. When you finish Restart the broker to incorporate the new files into the broker execution enironment. Install the TioliMonitor files on the Control Center. Procedure To install the TioliMonitor node.lil file on a broker system, run the Install TioliMonitor Node task in the MQSI Utility Tasks task library, specifying brokers as task targets. It is not necessary to specify the Configuration Manager Queue Manager or the Configuration Manager Host Name in the Install TioliMonitor Node task window when running the install task against brokers. Installing the TioliMonitor node on Control Centers Objectie To install the TioliMonitor node files on the Control Center. Background information You must install these files on the local system of eery user of the Control Center who needs to access the TioliMonitor node. These files are only accessed locally to each instance of the Control Center. This information is not held centrally in the configuration repository for shared access. Required authorization role The following authorizations are required: mqsi_senior Authorization to install the code for the plug-in on each system that will use it Before you begin You must connect the Control Center to the Configuration Manager, at least once, to create the directory structure where the Control Center files will be installed. When you finish When you hae completed installing the TioliMonitor node files onto the endpoint that hosts the Control Center, you must make these definitions aailable to the Control Center. Chapter 16. Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator 223

248 Procedure To install the TioliMonitor node files, run the Install TioliMonitor Node Task in the MQSI Utility Tasks task library, specifying as task targets the endpoints hosting the Control Centers. Inserting and deploying the TioliMonitor node Objectie To include the TioliMonitor node in your message flows. Background information With the TioliMonitor files installed, you can now include the TioliMonitor node in your message flows. Note: Each TioliMonitor node instance maintains a set of internal statistical counters. These counters are reset when the node processes its first message after its message flow is restarted. Updates are only sent if a message passes through the TioliMonitor node. If pacing is enabled, or if message flow has been restarted, it is possible that the counters may not reflect the most current state. Required authorization role WebSphere MQ Integrator authorization to define the node in the Control Center The user ID you are using must be a member of the WebSphere MQ Integrator group mqbrdet. Log in using the WebSphere MQ Integrator superuser ID. This causes the TioliMonitor node to be locked under the same user ID as all the supplied IBM primitie nodes. If you do not use this user ID, the definition files in the configuration repository might be accidentally unlocked, and therefore open to unauthorized update. Before you begin Install the TioliMonitor node on brokers and control centers. When you finish After the message flow is updated, deploy it to your brokers using the facilities of the Control Center. Procedure Use the following steps to add the TioliMonitor node definitions to the Control Center: 1. Start the Control Center 2. Select the Message Flows iew. 3. Select an existing Message Flow category, or create a new one. 4. Right click the selected category and select Add to Workspace Message Flow. A list box opens showing all existing IBM-supplied primitie nodes including the TioliMonitor node. 5. Select the TioliMonitor node. This node now appears within the message flow category you selected in the tree iew in the left-hand pane. 6. Right-click the new TioliMonitor node. Select Check In. 7. Right-click and select Lock. 8. Right-click again and select Check In for a second time. 224 IBM Tioli Monitoring for Business Integration: User s Guide

249 After this check-in, the interface and WDP definition files disappear from the local directory and go into the shared repository where they are aailable to all users of the Control Center. Users can use this new node only if they hae installed the additional files (icons and properties files, for example) on their own system. The TioliMonitor node has properties that must be configured. Set the properties as follows: ID Unique identifier for this instance of the TioliMonitor. The identifier has a maximum length of 63 characters. This identifier must be unique within the scope of the PerfDB serice specified in through the Performance Database Serer and Performance Database Port attributes. Performance Database Serer Host machine on which the PerfDB serice is installed. Either an IP address or a host name can be used; howeer an IP address is recommended because using host name resolution through a DNS serer can impact your message flow throughput. Performance Database Serer port Port used by the Tioli MQSI PerfDB serice. This alue must be specified, and it must match the port number used when installing the serice. The alid range is 1 to Flags Flags control the writing of a debug log and the pacing of information sent to the Tioli MQSI PerfDB serice. Flag alues and their meaning are as follows: 0 No debugging; no pacing. This is the default. 1 Turns on debug logging. Diagnostic information is written to the file C:\TiMontr.log on Microsoft Windows and /tmp/tiolimonitor.log on UNIX and proxy mode z/os. If debugging is enabled for multiple nodes on the same machine, all nodes will write their debugging information to the same file. Note: Debugging might hae a seere impact on performance. 2 Turns on pacing. Updates are sent to the serer no more than once per second. 3 Turns on debugging and pacing (options 1 and 2). Uninstalling the Tioli performance database serice You can uninstall the Tioli Performance Database Serice by running the MQSI Uninstall PerfDB Serice task in the MQSI Utility Tasks task library. When running the task, specify as task targets the Windows endpoints on which the PerfDB Serice was installed. The uninstall task will remoe the serice. Chapter 16. Setting up IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator 225

250 226 IBM Tioli Monitoring for Business Integration: User s Guide

251 Chapter 17. Working with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects After you define all the WebSphere MQ Integrator components, you can use them. This chapter describes tasks you can perform to use the newly created objects. Table 36 contains a list of the topics in this chapter and where you can find the procedures. Table 36. Working with objects in IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Goal Where to find procedures Understand the desktop icons and menus Working with objects on page 228 Delete an object Remoing Tioli objects on page 230 Manage objects using the Operations menu Using the Operation group on page 230 View the execution groups assigned to a broker Change or delete objects with the Configuration group Work with the monitoring setting for an object Using the Execution Groups window on page 232 Using the Configuration group on page 232 Using the Monitoring group on page 233 Display and work with log files Using the Diagnostics group on page 235 View the brokers and User Name Serers associated with a Configuration Manager Using the Members option on the Configuration Manager icon on page 236 IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator has menus on each of the object icons. These menus and their choices are present for each icon in its supported component states. The menus and their choices are context-sensitie. To see which options are aailable in which context for each icon, see Task menu paths for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator on page 331. You can work within the context of the WebSphere MQ Integrator resource using the menu icons. When aailable, the existing information about each distributed component is presented to you through the icon. You can see the current attribute settings before making changes. Note: Because of performance issues, current information for proxy mode z/os components is not displayed in the windows. When working with brokers, you can request information about execution groups and message flows. This information presents you with the name of execution groups in each broker and messages flows for each execution group. Each object also has a default action that you can launch by double-clicking the icon. The default action is context-sensitie. For all icons with an unknown status, double-clicking the object runs the Check Status task. For brokers that are in the up state, double clicking lists all execution groups associated with the broker. For all other objects in the up state, double-clicking displays the properties of the associated object. Copyright IBM Corp

252 Working with objects Desktop icons IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator uses icons to represent WebSphere MQ Integrator resources. These icons correspond to the three major WebSphere MQ Integrator components: brokers, Configuration Managers, and User Name Serers. Each of these components has a unique icon to represent it, allowing you to recognize brokers, Configuration Managers, and User Name Serers isually. In addition, proxy mode z/os components hae different icons from the distributed counterparts. Each icon is further qualified with a small state symbol in the lower right corner. This symbol allows you to see if the component status is up, down, or unknown. Unknown is an intermediate state, which means that the component s queue manager is not running or the component status cannot be determined. All components share the same state symbols for up, down, and unknown. The broker icon has a special fourth state, Limited, to symbolize that while the broker itself is up, one or more of the message flows for that broker is down. These icons and their state symbols are illustrated in Table 37 and Table 38. Table 37. Broker icon states Distributed icon proxy mode z/os icon State Up Down Unknown Limited Table 38. Configuration Manager icon states Icon State Up Down 228 IBM Tioli Monitoring for Business Integration: User s Guide

253 Table 38. Configuration Manager icon states (continued) Icon State Unknown Table 39. User Name Serer icon states Distributed icon proxy mode z/os icon State Up Down Unknown Menu structure In addition to sharing common states, the component icons also share similar menu structures. Each menu consists of a common set of options. The broker and Configuration Manager icons hae an additional option. Most options on the main menus open a second menu automatically. At this second menu, you hae access to all of the functionality. Third leel menus, when present, are proided only to actiate or deactiate functions seen at the second leel. No menu path is more than three leels deep. Each menu is organized into the following three groups: Component options Depending on the component, the component options hae either two or three choices. This group, and its choices, support starting, stopping, changing, deleting, iewing properties, and getting an immediate status update. The third choice, when present, proides facilities for accessing resources owned by the component. For example, the broker has a third choice that enables you to access execution groups. Tioli management options This group proides tools to iew the IBM Tioli Monitoring resource models deployed to the component, tools to manage the eent adapters, and tools to manage both Tioli log files and WebSphere MQ Integrator traces. Help Each menu has its own help panel that proides information for using the icon menus. Chapter 17. Working with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects 229

254 Remoing Tioli objects There are three ways you can remoe Tioli objects from the Tioli desktop. Using the Operation group Delete using the task library The MQSI Operational Tasks task library contains tasks for deleting brokers, Configuration Managers, and User Name Serers. You run these tasks to delete the actual WebSphere MQ Integrator components on target machines. When the WebSphere MQ Integrator component is deleted, the corresponding Tioli object is automatically remoed from the Tioli serer. Delete from the Tioli desktop You can delete objects from the Tioli desktop by selecting the objects and using the policy region Edit->Delete menu option. When you delete objects in this manner, the objects are remoed from the Tioli region. The Control Center is not affected. The WebSphere MQ Integrator components are still running, but you can no longer manage them from Tioli. Delete using CLI commands IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides a set of commands to delete the Tioli objects. Like the delete function from the Tioli desktop, these commands delete only the Tioli object and not the WebSphere MQ Integrator component on the target machine. For information on how to use these commands, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide. Regardless of which approach you use to delete Tioli objects, the following eents occur: The Tioli object is remoed from the Tioli region The corresponding icon is remoed from the Tioli desktop The object is remoed as a subscriber from all profile managers and any other profile managers to which the component had been subscribed. Objectie To use the Operation menu on the desktop icon to manage objects, such as checking the status of a component. Background information Not applicable. Required authorization role mqsi_user Before you begin Not applicable. When you finish Not applicable. Procedure Use the following steps to open the Operation menu: 1. Double-click the policy region that contains the WMQI objects to open the Policy Region window. 2. Right-click the object that you want to work with. 230 IBM Tioli Monitoring for Business Integration: User s Guide

255 3. Click Operation to open the Operation pop-up menu. Figure 36. Operation menu You can perform the following actions from the Operation menu: Properties Collects and displays attribute information for the component. This information includes such items as the host operating system, the queue manager name, and user IDs. Check Status Checks and updates the component status. While IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides automatic checking with the Component Status resource model, you can use this action to check a component s state between monitoring interals. In addition to checking component status, this option also reports status for the Tioli log file adapter, the MQSI eent adapter, and Tioli logging. Note: The Tioli log file adapter is not aailable for proxy mode z/osproxy mode z/os systems. Queue Manager Displays the WebSphere MQ queue manager icon, if the queue manager for this component is defined to IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. From this icon, you can perform management operations on the queue manager. Start Starts the component. This option is only aailable if the component is down. Stop If starting the component is successful, the icon is updated to the Unknown state. It does not reflect an Up state until the Component Status resource model runs. Shuts down a component. This option is aailable when the component is up or unknown and when a broker has a limited state. As a safeguard against accidental selection, you are prompted to confirm the stop action. If stopping the component is successful, the icon is updated to the Down state. If it is not successful, the icon is changed to the Unknown state. Message Flows Displays additional options for the message flows. This option is only aailable from broker components. You can start or stop all message flows. Chapter 17. Working with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects 231

256 As a safeguard against accidental selection, you are prompted to confirm the stop action for message flows. To start and stop indiidual message flows, use the Execution Group option. For proxy mode z/os components, there are two additional options: Start Controller Starts a proxy mode z/os component s controller. A controller is a proxy mode z/os subsystem that enables communication to and from a proxy mode z/os broker or User Name Serer. After the controller is started, the component can be started. Stop Controller Stops a proxy mode z/os component s controller. Using the Execution Groups window The Execution Groups window displays the set of execution groups assigned to a broker. For the list of execution groups, you can do the following: Execute tasks on an execution group Work with the Serice and User traces for an execution group Display and change the trace settings Request a log report Work with the message flows in an execution group Start or stop message flows Work with indiidual message flows in another window The Message Flows window displays the set of message flows assigned to an execution group. Any tasks initiated from this window are performed on the selected message flow, within the context of the owning execution group and broker. You can start or stop a specific message flow from this window, as well as display and change the trace settings. Using the Configuration group Objectie To use the Configuration group on the desktop icon to change or delete objects. Background information The Configuration group consists of the change and delete options. The broker and User Name Serers also include the Set Membership option. Required authorization role mqsi_user Before you begin Not applicable. When you finish Not applicable. 232 IBM Tioli Monitoring for Business Integration: User s Guide

257 Procedure Use the following steps to open the Configuration menu: 1. Double-click the policy region that contains the objects to open the Policy Region window. 2. Right-click the object with which you want to work. 3. Click Configuration to open the Configuration pop-up menu. Figure 37. Configuration menu Using the Monitoring group You can perform the following actions from the Configuration menu: Change Displays a change window that enables you to change the attributes for a component. The current attributes are displayed so that you can determine if changes are really necessary. This option is only aailable if the component is down. Delete Displays a delete window that seres as both a confirmation for the delete action and as a way to specify related items for deletion. This option is only aailable if the component is down. Note: Deleting a broker and a Configuration Manager requires specific procedures. Multiple confirmations are displayed about this. Set Membership Assigns a broker or a User Name Serer as a member of a Configuration Manager domain. A list of known Configuration Managers opens, from which you can select a specific Configuration Manager. Objectie To use the Monitoring group on the desktop icon to manage resource models. Background information The Monitoring group consists of options that help you manage the resource models for each component. Required authorization role mqsi_user Before you begin Not applicable. Chapter 17. Working with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects 233

258 When you finish Not applicable. Procedure Use the following steps to open the Monitoring menu: 1. Double-click the policy region that contains the IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects to open the Policy Region window. 2. Right-click the object that you want to work with. 3. Click Monitoring to open the Monitoring pop-up menu. Figure 38. Monitoring menu You can perform the following actions from the Monitoring menu: Profiles Proides tools to open and control the IBM Tioli Monitoring profiles distributed to a component. You hae the following three choices: Open Displays all the profiles distributed to the component. From the list of profiles, you can open the profiles, edit the profiles, add and remoe resource models from the profiles, and enable and disable resource models from the profiles. Any changes you make to the profile affect only the copy of the profile distributed to this component. Other components are not affected by the changes you make locally to this profile. To change the profile for all components, change the master profile and redistribute that profile to all subscribers. Enable All Enables all resource models in all profiles distributed to the component. Disable All Disables all resource models in all profiles distributed to the component. This option is useful if you need to stop the component and you do not want IBM Tioli Monitoring eents reported for the component while it is stopped. Logfile Adapter Proides tools to manage the Tioli log file adapter for this component. You hae the following choices: Start Starts the log file adapter on the machine running the component. 234 IBM Tioli Monitoring for Business Integration: User s Guide

259 Stop Enable Using the Diagnostics group Stops the log file adapter on the machine running the component. Enables the log file adapter. The log file adapter is used to monitor component log files. Disable Disables the log file adapter. Disabling the log file adapter stops the reporting of message eent for this component. Notes: 1. Both the Enable and Disable options restart the log file adapter, if necessary, to make the changes effectie immediately. 2. The Tioli log file adapter is not aailable on proxy mode z/os systems. MQSI Eent Adapter Proides tools to manage the MQSI eent adapter from a broker. You hae the following choices: Start Starts the MQSI eent adapter on the machine running the component. Stop Stops the MQSI eent adapter on the machine running the component. Note: You are not prompted to confirm this action. Configure Displays a window on which you can change eent topics and enable or disable MQSI eent adapter logging. Note: This function is not aailable for proxy mode z/os systems. For information on using the MQSI eent adapter on proxy mode z/os, see the IBM Tioli Monitoring for Business Integration Installation and Setup Guide. Objectie To use the Diagnostics group to open and work with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator log files and WebSphere MQ Integrator log files. Background information Not applicable. Required authorization role mqsi_user Before you begin Not applicable. When you finish Not applicable. Procedure Use the following steps to open the Diagnostics menu: 1. Double-click the policy region that contains the WMQI objects to open the Policy Region window. Chapter 17. Working with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects 235

260 2. Right-click the object with which you want to work. 3. Click Diagnostics to open the Diagnostics pop-up menu. Figure 39. Diagnostic menu You can perform the following actions from the Diagnostics menu: MQSI Logs Opens a window from which you can request a log report. The output of the log file is limited to the last 500 lines. Serice Trace Enables you to change the serice trace settings for the component. The current trace settings are displayed so that you can determine if changes are necessary. This option is only aailable if the component is running. Tioli Logs Opens a window from which you can request endpoint or callback log files. All aailable endpoint or callback logs are displayed. From the list of logs, you can choose an indiidual log to open or you can delete a log. Choose one of the following Endpoint Displays all IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator log files for the component on the endpoint. This includes task logs, monitor logs, and eent adapter logs. Callback Displays all IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator callback logs for the component. Using the Members option on the Configuration Manager icon Objectie To use the Members option to iew the brokers and User Name Serers associated with a Configuration Manager. Background information The Members option on the Configuration Manager icon opens a window in which you iew the brokers and User Name Serers associated with this Configuration Manager. You assign members to a Configuration Manager using the Set 236 IBM Tioli Monitoring for Business Integration: User s Guide

261 Membership option on the broker and User Name Serer icons or with the Discoer function described below. You display members in a Configuration Manager using this option. When you select this option, a window opens that contains only the components assigned to this Configuration Manager. You can perform all of the actions on these icon copies that you can on the master icons. Howeer, when working in this window, the icons are not automatically updated when their states change. You will need to use the Refresh option to get the latest states and to reflect any changes in members being added or remoed from this Configuration Manager. Required authorization role mqsi_user Before you begin Not applicable. When you finish Not applicable. Procedure Use the following steps to open the Members menu: 1. Double-click the policy region that contains the WMQI objects to open the Policy Region window. 2. Right-click a Configuration Manager. 3. Click Members to open the Members pop-up menu. You can perform the following actions from the Members menu: Open Displays the set of brokers and User Name Serers assigned to this Configuration Manager. Discoer Discoers the set of brokers and the User Name Serer for this Configuration Manager. All members not found will first be remoed, then only the brokers that are in the configuration database and, if applicable, the Configuration Manager s User Name Serer are added. Brokers or User Name Serers can be added manually using the Set Membership option on the icon, but will be remoed from the membership during the Discoer process. Chapter 17. Working with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator objects 237

262 238 IBM Tioli Monitoring for Business Integration: User s Guide

263 Part 4. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Copyright IBM Corp

264 240 IBM Tioli Monitoring for Business Integration: User s Guide

265 Chapter 18. Quick-reference guide for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Table 40 contains a list of the goals and procedures for getting started with IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer and cross-references to places where you can find additional information about each procedure. Getting started with IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer requires installing the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Tioli Management Framework based functions first. The IBM Tioli Monitoring for Business Integration Installation and Setup Guide proides the details of this process. Table 40. Quick-reference information for getting started with IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Goal Starting 1. Access the interfaces in the Tioli enironment so you can use the operations and functions of IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Setting up administrators to use the software 2. Assign the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer authorization roles to one or more Tioli administrators. Note: You must assign both Tioli and WebSphere InterChange Serer authorization roles to administrators. Setting up managed resources 3. Create WebSphere InterChange Serer objects. Where to find procedures Accessing the Tioli Management Framework enironment on page 32 Setting authorization roles on page 33. Authorization roles for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer on page 322 lists the authorization roles required for each procedure. See the Tioli Management Framework User s Guide for information about how to assign authorization roles to Tioli administrators. Discoering InterChange Serers on page Set up the SNMP agent. Configuring SNMP Agents on page 256 Setting SNMP Community Names on page Discoer adapter agents. Discoering adapter agents on page 260 Setting up monitoring profiles and tasks 6. Set up the resource model. Chapter 3, Working with resource models, on page 49. Also see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide for information about the resource model. (Optional) View daily reports in the IBM Tioli Monitoring Web Health Console View statistics regarding your enironment in the IBM Tioli Monitoring Web Health Console. (Optional) Create historical reports in the Tioli Enterprise Data Warehouse Chapter 4, Viewing resource model results with the IBM Tioli Monitoring Web Health Console, on page 73 Copyright IBM Corp

266 Table 40. Quick-reference information for getting started with IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer (continued) Goal Configure Tioli Enterprise Data Warehouse to iew data for use with IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. (Optional) Connecting to IBM Tioli Enterprise Console Set up IBM Tioli Enterprise Console so you can iew actiity reports for your enironment. Where to find procedures Chapter 5, Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse, on page 75 Chapter 6, Integrating with IBM Tioli Enterprise Console, on page IBM Tioli Monitoring for Business Integration: User s Guide

267 Chapter 19. Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer This chapter describes how to set up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. Table 41 proides a list of the goals you can achiee using the information and procedures in this chapter. The table also tells where to locate information about the procedures for each goal. The goals and procedures are listed in the order in which you should perform them. Table 41. Configuring IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Goal 1. Access the interfaces in the Tioli enironment so you can use the operations and functions of IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer 2. Assign the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer authorization roles to one or more Tioli administrators. Where to find information and procedures Accessing the Tioli Management Framework enironment on page 32 Setting authorization roles on page Configure the eent serer. Configuring the eent serer on page Define InterChange Serer installations to the Tioli enironment (create WebSphere InterChange Serer objects). Discoering InterChange Serers on page 251 Defining InterChange Serers manually on page Set up the SNMP agent. Configuring SNMP Agents on page 256 Setting SNMP Community Names on page Define adapter agents. Discoering adapter agents on page 260 Defining Adapter Agents manually on page 261 IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer oeriew IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides a robust set of monitoring and management capabilities to support the operation of a WebSphere InterChange Serer installation. Seeral Tioli management technologies proide these management capabilities. Copyright IBM Corp

268 Tioli Management Framework Tioli Management Framework proides the core management capabilities. You use Tioli Management Framework to define your InterChange Serer configuration to Tioli and to perform daily monitoring and management tasks. Getting started with IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer requires installing the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer functions that are based on Tioli Management Framework first. The IBM Tioli Monitoring for Business Integration Installation and Setup Guide contains the details of this process. For more information about the integration of IBM Tioli Monitoring for Business Integration software with Tioli Management Framework See 1- Tioli Management Framework on page 6. Tioli Enterprise Data Warehouse functionality complements the Tioli Management Framework. You can use Tioli Enterprise Data Warehouse to reiew historical information using reports proided with the software or you can generate your own reports. See Chapter 5, Enabling IBM Tioli Monitoring for Business Integration for Tioli Enterprise Data Warehouse, on page 75 for more information about the integration of IBM Tioli Monitoring for Business Integration software with Tioli Enterprise Data Warehouse. Defining your InterChange Serers to Tioli After the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer function is installed, you must define your InterChange Serer installations to Tioli. You can do this in two following ways: Discoery The discoery function is a way for you to run a Tioli task that scans one or more endpoints for installed InterChange Serer instances. Refer to the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide and Discoering InterChange Serers on page 251 for details about this task. Manual definition If you know a basic set of information about your InterChange Serer installations, you can manually define them to Tioli. Perform manual definition from within the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer policy region. See Defining InterChange Serers manually on page 253 for details about using this function. Understanding the SNMP Agent The WebSphere InterChange Serer product proides a basic system management interface through an SNMP agent. The IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer product requires that the WebSphere InterChange Serer SNMP agent be installed in order for the Tioli functions to operate. If you do not hae the WebSphere InterChange Serer SNMP agent installed, you will need to install it before you can use the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer functions. Refer to WebSphere InterChange Serer installation manuals for installing the WebSphere InterChange Serer SNMP agent. 244 IBM Tioli Monitoring for Business Integration: User s Guide

269 IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer relies extensiely on the SNMP agent that the WebSphere InterChange Serer product proides in order to proide management capabilities oer the WebSphere InterChange Serer. The dependency on the WebSphere InterChange Serer SNMP agent makes it essential for the SNMP agent to be configured correctly and running. The SNMP agent is a system management extension to the WebSphere InterChange Serer. Thus, while the Tioli software requires the SNMP agent, the WebSphere InterChange Serer itself does not require the SNMP agent to perform its business integration tasks. The administrator who installed the WebSphere InterChange Serer might not be familiar with the SNMP agent nor with SNMP concepts. SNMP agents are management programs that interact with an application through a set of application defined attributes. These attributes are defined by the application in a Management Information Base (MIB) file. WebSphere InterChange Serer defines its MIB in the cwsnmpagent.mib file, proided with the product. An SNMP agent can retriee alues from the MIB and, if the MIB allows, can set selected alues. The WebSphere InterChange Serer SNMP agent uses an object request broker to communicate with an InterChange Serer. This allows the SNMP agent to reside on the same machine with the InterChange Serer, or it can reside on a different machine. Tioli software supports both configurations. The SNMP agent is not a managing application; it is an interface program through which an SNMP managing application makes requests to retriee data and set management attributes. In the Tioli enironment, the Tioli software performs the role of the SNMP managing application. The SNMP agent communicates with an SNMP managing application using the UDP protocol. The UDP protocol also allows the SNMP agent and the SNMP managing application to reside on the same machine or on different machines. The Tioli software supports both configurations. The SNMP architecture defines mechanisms through which an SNMP agent can be configured. For the WebSphere InterChange Serer SNMP agent, these configuration settings define the InterChange Serers that the SNMP agent manages and the host machines on which the SNMP managing application can run. Both of these items are configured into the SNMP agent serer access table. This table is essentially a set of table rows, each row of which contains an InterChange Serer name and the host from which the SNMP managing application can make requests. In addition to machine leel access, SNMP agents also proide authorization checking. Authorization checking is implemented using community names. There are two types of community names: Read community names allow an SNMP managing application to retriee data alues from the SNMP agent s MIB. Write community names allow an SNMP managing application to set data alues from the SNMP agent s MIB. Setting MIB alues proides a way for the managing application to request changes in the managed application (the InterChange Serer). Read and Write Chapter 19. Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer 245

270 community names can be shared across managing applications, or they can be configured for each managing application. In either case, the Read and Write community names must be defined to the SNMP agent. While the SNMP agent configuration settings define which applications can access it, the Tioli software must also be configured to tell it how and where to access the SNMP agent, and it must be gien permission to access the SNMP agent. In order to access the SNMP agent, the Tioli software must know the machine on which the SNMP runs, and it must know the port number used to access that SNMP agent. To access the SNMP agent, you must proide the following information to the Tioli software: Host name of the machine on which the SNMP agent runs Port number to which to connect the SNMP agent Read community name to retriee information from the SNMP agent Write community name to set alues in the SNMP agent Because the SNMP agent is so important to the Tioli functions, the WICSnmpAgent object is created automatically when the WICSerer object is created. The WICSerer policy region contains this WICSnmpAgent. It is named host name>. An example of the WICSnmpAgent icon name is You can iew the icon by opening the WICSerer policy region. After the SNMP agent is installed and configured, you need to alidate that the Tioli software can communicate with it and with the InterChange Serer. Perform the following tasks to check arious aspects of this important configuration: Reiew the WICSnmpAgent properties See Viewing SNMP agent properties on page 271 for information about this task. Reiew the host name and port numbers for correctness. If the SNMP runs on the same machine as the InterChange Serer and the port number is correct, then basic communication should work. If the SNMP agent runs on a different host from the InterChange Serer or the port number is different than shown, then refer to Changing the SNMP host on page 275 for steps to take to define the correct configuration to Tioli. Check the status of the WICSnmpAgent Go to the WICSnmpAgent icon, right click, and run Operations Check Status. If the task reports up status, then continue. If the status is not up, then try starting the SNMP agent using the icon function described in Checking status on page 265 Check the SNMP community names In order to communicate with an SNMP agent, the calling program must be authorized to the SNMP agent. Authorization occurs in two ways: SNMP calls are made from a host machine to the SNMP agent. The host name from which the calls are made must be defined in the SNMP agents access table. This Tioli software will automatically add this correct hostname when accessing the SNMP agent. Programs calling an SNMP agent must proide access codes known as community names. There are two types of community names. Read community names allow the calling program to retriee information from the SNMP agent. Write community names allow the calling program to set information in the SNMP agent. The Tioli software is installed with default alues for both of these community names. The default for the read and write community names are public and administrator, respectiely. If you are using 246 IBM Tioli Monitoring for Business Integration: User s Guide

271 different community names for the SNMP agent, you will need to define the new community names to Tioli. Refer to Setting SNMP Community Names on page 258 for detailed steps on performing this task. Complete checking of the SNMP agent by checking the status of the InterChange Serer. This function uses the SNMP agent to get the status of InterChange Serer. If the task reports status of Up or Down, the SNMP communication is correct. If the task reports Unknown, the SNMP agent might not be properly configured. Reiew the bullet list on page on page 246. Viewing Information about your InterChange Serers IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides seeral ways to iew information about an InterChange Serer and its resources: Properties Properties are static alues associated with an InterChange Serer, an SNMP agent, or an adapter agent. You can iew the properties of each resource type from its icon. The properties proide information such as resource name, InterChange Serer name, installation directory, and configuration file name. Collaborations Collaborations are processing resources used within an InterChange Serer. You can iew all collaborations currently defined in each InterChange Serer by opening the Collaborations windows from a WICSerer icon. From the displayed window, you can take additional actions such as starting, pausing, stopping, or checking status of indiidual collaborations. Adapter controllers Adapter controllers are processing resources used within an InterChange Serer. You can iew all adapter controllers currently defined in each InterChange Serer by opening the adapter controllers windows from a WICSerer icon. From the displayed window, you can take additional actions such as starting, pausing, stopping, or checking status of indiidual adapter controllers. Log files You can iew InterChange Serer log files, InterChange Serer trace files, the SNMP agent log file, and under certain conditions adapter agent log files. These log files are accessed for each resource type from its icon. Status IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides a check status function that behaes according to the resource status being checked. Each icon displays status isually using status indicators. The WICSerer icon is updated automatically by the WICS Serer Status resource model. You can manually check its status from a task library or from the icon. When checking status, the icon state is updated, the state is reported in the task output, and if the InterChange Serer is up the information about all collaborations and adapter controllers is reported. The WICSnmpAgent and WICSAdapterAgent icons are not updated automatically. You can manually check the status from a task library or from the icon. When checking status, the icon state is updated and the state is reported in the task output. Collaboration status is reported in the Collaborations window when the window is opened. The status for all collaborations can be updated by Chapter 19. Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer 247

272 refreshing the window. The status of an indiidual collaboration can be checked by selecting the collaboration and inoking the check status action. This latter option is necessary to determine whether a non-running collaboration is stopped or paused. Adapter controller status is reported in the Adapter Controllers window when the window is opened. The status for all Adapter controllers can be updated by refreshing the window. The status of an indiidual adapter controller can be checked by selecting the adapter controller and inoking the check status action. This latter option is necessary to determine whether a non-running adapter controller is stopped or paused. Taking actions on your InterChange Serers Chapter 22, Working with InterChange Serers, on page 277 proides information about the tasks you can use to monitor and manage an InterChange Serer and its resources. The procedures in that chapter describe how to initiate the tasks in different ways such as using resource icons, task libraries, and resource windows. Running a task on an eent on page 115 in Chapter 6, Integrating with IBM Tioli Enterprise Console, on page 93 describes how to run tasks using IBM Tioli Enterprise Console. Understanding the resource model IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides one resource model, the InterChange Serer Status resource model. The IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide proides a complete description of this resource model. The InterChange Serer Status resource model detects the following conditions: An InterChange Serer is not processing any work, most likely due to external conditions such as a network problem, system problem, database problem, or WebSphere MQ problem Specific collaborations in an InterChange Serer are not processing work, possibly because a needed resource is unaailable. Collaborations are in a potential deadlock situation. Adapter resources (controllers and agents) are unaailable when collaborations hae work to do. Business applications are unaailable when collaborations hae work to do. An InterChange Serer is running low on memory. Tioli monitoring software is unable to communicate with the InterChange Serer due to connection problems, usually problems with the SNMP agent. These error situations are reported on both the Web Health Console and on the Eent Console. The Web Health Console shows the state of resources progressiely so that you can see a problem being detected and worsening as the monitoring process continues. The Eent Console shows the status of a problem after it has been determined to hae occurred, that is, the Web Health Console reports health at 0%. Using the Web Health Console, you can iew information leading up to the problem. 248 IBM Tioli Monitoring for Business Integration: User s Guide

273 Using the Eent Console, you can iew the problem once it has occurred. The Eent Console proides the ability to run tasks to correct selected problem conditions. Deploying the resource model The resource model is deliered in the WICS Serer Status profile in the WICS Serer Resource Models profile manager. As WICSerer objects are created, they are automatically added as subscribers to the WICS Serer Resource Models profile manager. Howeer, the resource model is not automatically distributed to the object. You first need to alidate the SNMP agent configuration parameters, especially the read community name, then distribute the resource model to the WICSerer object. Recoery tasks The Eent Console proides the ability to run tasks to correct selected problem conditions. These actions consist of start commands to the InterChange Serer or one of its resources. You can use the configuration capabilities of the resource model to automatically inoke these actions when they occur. See Specifying tasks for an indication on page 60 in Chapter 3, Working with resource models, on page 49. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides the WICS Automated Tasks task library for use with the resource model. Using IBM Tioli Enterprise Console with InterChange Serer eents IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides seeral capabilities to support managing an InterChange Serer from the Tioli eent console: Eent classes Eent rules Eent scripts Eent console tasks See Eent classes and rules for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer on page 359 in Appendix C, Eent classes and rules, on page 339 for detailed information. Use in interconnected Tioli regions IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides limited support for interconnected Tioli regions. You can install IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer in the following situations: Regions interconnected, IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer not installed in either region. You can install the product in one or both regions. Regions not interconnected, IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer not installed in either region. You can install the product in both regions, then you can interconnect them. Regions not interconnected, IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer installed in one region. You can interconnect the Tioli regions and install the product in the second region. Chapter 19. Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer 249

274 You can uninstall IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer in the following situations: Regions not interconnected, IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer installed in both regions. You can uninstall the product from one region, then you can interconnect them. Regions interconnected, IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer installed in one or both regions. You can uninstall the product in either or both regions. The IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer objects (WICSerer, WICSnmpAgent, WICSAdapterAgent) are not qualified by region name. Objects labels, a domain name for example, must be unique across all interconnected Tioli regions. Understanding Tioli object locations This section proides information about Tioli objects, their assignment, and how their location can affect your recoery strategy. WICSerer, WICSnmpAgent, and WICSAdapterAgent are the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer objects. There are seeral important points about Tioli objects: All objects must exist on a managed node in a Tioli region. The managed node may be selectable or it may be predefined. Once an object is created on a managed node, it cannot be moed. The object must be deleted and recreated in order to moe it. If you are using objects, for example running check status against a WICSerer, the object must be accessible in order for the function to complete. If the managed node hosting the object is not aailable, then the request to the object will fail. If you are planning for a high aailability configuration, you need to ensure that the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer objects are created on a high aailability managed node. When you run the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer discoer or object creation functions, you can choose a specific managed node on which to hae the objects created. You can specify one of your high aailability managed nodes for this purpose. The discoer and object creation functions allow you to as the managed node. When you choose this option, you are asking the Tioli software to select the managed node for you. The managed node is selected based on the gateway currently sericing the endpoint on which the InterChange Serer resource runs. The managed node selected might not be a high aailability managed node. You can iew the object locations using the Properties function of the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer objects. The managed node on which the object resides is reported as the Object Host. Reconfiguration options You can use the following information to control the configuration of your IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer: Changing an InterChange Serer Configuration file 250 IBM Tioli Monitoring for Business Integration: User s Guide

275 See Changing configuration files on page 283. Changing host names used by an InterChange Serer See Changing hosts on page 284 Changing the SNMP agent attributes See SNMP agent configuration on page 256. Using relationship information IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides tools to help you understand and sole problems from external sources that can affect your InterChange Serer. These tools proide support for the MQ queue manager and the database manager that the InterChange Serer uses. Accessing the MQ queue manager: An InterChange Serer requires a message deliery facility. The IBM WebSphere MQ product is often used for this purpose. Problems in a WebSphere MQ queue manager can affect the operation and performance of the InterChange Serer. If you hae IBM Tioli Monitoring for Business Integration: WebSphere MQ installed, you can manage the queue manager that the InterChange Serer uses. Refer to Viewing queue managers on page 267 for details about this procedure. Discoering InterChange Serers Objectie To create objects that represent your InterChange Serers. Background information After the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer function is installed, you must define your InterChange Serer installations to Tioli in one of the following ways: Discoery The discoery function that is described in this section is the preferred way to define the InterChange Serer installations to Tioli. Manual definition See Defining InterChange Serers manually on page 253 for details about using this function. The discoery function is a way for you to run a Tioli task that scans one or more endpoints for installed InterChange Serer instances. The discoer task identifies InterChange Serers by searching specified endpoints for InterChange Serer signature files. These signature files are the.ior files created by an InterChange Serer when it is started. The signature files are located in the WebSphere InterChange Serer installation directory. The installation directory is also dynamically determined by the discoer task. For a Windows endpoint, the task takes the installation directory from the CROSSWORLDS enironment ariable. If this ariable is not defined, the task does not report any InterChange Serers for that operating system. For a UNIX endpoint, the task deries the installation directory from the location of any.ior files in the operating system. When InterChange Serers are found, they are defined in Tioli as WICSerer objects. All WICSerer objects are created in the Monitoring for WebSphere ICS policy region. Chapter 19. Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer 251

276 For each InterChange Serer defined to Tioli, the software creates a WICSerer icon for that InterChange Serer in the Monitoring for WebSphere ICS policy region. The icons are named for the InterChange Serer using the naming conention of <ICS name>@<ics host name>. For example, an InterChange Serer named Sales-ICS running on host aixsales would hae a WICSerer object with the following name: Sales-ICS@aixsales. This task proides the following output: The set of InterChange Serers that were found. InterChange Serers which are added to the Tioli enironment and characteristics of those enironments. Any errors in the object creation process. Any InterChange Serers that were already defined to Tioli. Any endpoints that were not searched because of errors communicating with the endpoint. Required authorization role wics_admin Before you begin Perform the following actions: Identify the set of endpoints that the task is to check for InterChange Serer installations. Determine how you will assign object locations for Tioli objects and hae the set of gateways used for this purpose. Refer to Understanding Tioli object locations on page 250 for more information about object locations. Ensure that you hae the required authorization role to run this task. See Setting authorization roles on page 33 for more information. When you finish After you define an InterChange Serer, you must configure the WebSphere InterChange Serer SNMP agent for management access by Tioli software. After you finish this task, you can run operational tasks against the InterChange Serer to determine its health and see its resources. You can also deploy the resource model to the InterChange Serer to monitor its health on an ongoing basis. Distribute the monitoring profiles. See Distributing profiles on page 43 for more information. Procedure You can perform this procedure from the Tioli desktop using an icon context menu or a task library. Icon context menu: Initiate the Discoer InterChange Serers task from the Monitoring for WebSphere ICS product icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Steps: 1. Right-click the Monitoring for WebSphere ICS icon. 2. Select Discoer InterChange Serers. 3. Select one or more endpoints from the Tioli Endpoints list. 252 IBM Tioli Monitoring for Business Integration: User s Guide

277 Additional Information: The list shows only endpoints managed by this Tioli region. The task does not support discoery on endpoints in other Tioli regions. 4. Select one managed node from the Object Host field. Additional information: If you select a specific managed node, all WICSerer objects are created on that managed node. If you each WICSerer object is created on the managed node currently sering as the gateway for the endpoint on which the InterChange Serer was found. 5. Click Set and Execute to run the task. Additional information: The task might run for seeral minutes. 6. Reiew the task output. Task library: Run the Discoer InterChange Serers task from the WICS Configuration Tasks task library. For information about running a task from a task library, see Task library on page 145 steps. For more information about the Discoer InterChange Serers task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Defining InterChange Serers manually Objectie To create objects that represent your InterChange Serers without using the discoery function. Background information After the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer function is installed, you must define your InterChange Serer installations to Tioli in one of the following ways: Discoery See Discoering InterChange Serers on page 251 for details about this task, which is the preferred way to define the InterChange Serer installations to Tioli. Manual definition This section proides information about this task. Manual definition creates a WICSerer object in Tioli based on information you proide. The create process alidates information you enter and uses that information to retriee additional information from the InterChange Serer configuration. When InterChange Serers are added, they are defined in Tioli as WICSerer objects. The WICSerer object is created in the policy region in which you inoke the create process. If you know a basic set of information about your InterChange Serer installations, you can manually define them to Tioli. Perform manual definition from within the policy region using the create functions from the menu. For each InterChange Serer defined to Tioli, the software creates a WICSerer icon for that InterChange Serer in the Monitoring for WebSphere ICS policy Chapter 19. Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer 253

278 region. The icons are named for the InterChange Serer using the naming conention of <ICS host name>. For example, an InterChange Serer named Sales-ICS running on host aixsales would hae a WICSerer object with the following name: Sales-ICS@aixsales. Required authorization role wics_admin Before you begin Identify the endpoint on which the InterChange Serer is installed. Determine how you will assign object locations for Tioli objects and hae the set of gateways used for this purpose. Refer to Understanding Tioli object locations on page 250 for an understanding of object locations. Hae the following pieces of information aailable to complete the fields in the window: InterChange Serer name Configuration file name InterChange Serer administrator ID (UNIX only) InterChange Serer installation directory (UNIX only) Configuration file directory, if different than the installation directory (UNIX only) The name of the policy region in which you want to create the new WICSerer object. Ensure that the policy region has WICSerer as a managed resource. When you finish After you define an InterChange Serer, you must configure the WebSphere InterChange Serer SNMP agent for management access by Tioli software. After you finish this task, you can run operational tasks against the InterChange Serer to determine its health and see its resources. You can also deploy the resource model to the InterChange Serer to monitor its health on an ongoing basis. Distribute the monitoring profiles. See Distributing profiles on page 43 for more information. Procedure You can perform this procedure from the Tioli desktop. Steps: 1. Open the Monitoring for WebSphere ICS policy region. 2. Select Create WICSerer from the menu to open the Create WICSerer window. 254 IBM Tioli Monitoring for Business Integration: User s Guide

279 Figure 40. Create WICSerer window 3. Complete the fields and options in the Create WICSerer window as follows: Additional information: Refer to the online help for more information about this task. a. Type the InterChange Serer name in the Name field. b. Type the configuration file name in the Configuration File field. c. Type the InterChange Serer administrator ID in the Administrator ID field. d. Click the Tioli endpoint in the Endpoint Name list. e. Click one managed node in the Object Host list. Additional information: The WICSerer object will be created on this managed node. If you select a specific managed node, the WICSerer object will be created on that managed node. If you the WICSerer object will be created on the managed node currently sering as the gateway for the selected endpoint f. If the endpoint that you selected in step 3d is a UNIX endpoint, the installation directory field will be enabled. Type the path to the installation directory in the Installation Directory field. If the endpoint that you selected in step 3d is a Windows endpoint, the installation directory will be disabled. The installation directory will be deried from the CROSSWORLDS enironment ariable on the endpoint. g. Type the path to the directory for the configuration file in the Configuration File Directory field, if the path is different from the installation directory. h. Click Set and Execute to run the task. Chapter 19. Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer 255

280 4. Reiew the task output. Configuring SNMP Agents Objectie To configure the basic startup options of the SNMP agent: Polling delay Port number Log directory Serice name Background information SNMP agent interface: The Tioli management software uses the WebSphere InterChange Serer SNMP agent as the interface to access information about an InterChange Serer and its resources. Both products must be configured to use the same port number in order for the Tioli software to connect to the SNMP agent. This task sets the port number in both products. The SNMP agent gets information from the InterChange Serer by polling the InterChange Serer at defined interals. The information reported to Tioli about the InterChange Serer is only as current as the information reported by the SNMP agent. The polling delay tells the SNMP how often to get InterChange Serer information. It is important to hae reasonably current information from the SNMP agent in order for the InterChange Serer Status resource model to report meaningful information. The SNMP agent proides support for a log file and can run as a serice on Windows platforms. This task allows you to set a log file for the SNMP agent and define that serice name to the Tioli software. SNMP agent configuration: When a WICSerer object is created, a WICSnmpAgent object is also created automatically. This object has the following default attributes: SNMP agent host host on which the InterChange Serer is running SNMP port 161 for Windows, 1161 for UNIX Read community name public Write community name administrator Serice Not run as a serice These parameters must match the SNMP agent configuration. Reiew these parameters and make any necessary configuration changes before attempting to use the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer software. If these parameters are not consistent between the Tioli definition and the actual SNMP agent, communication with the SNMP agent does not work and many of the functions proided by IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer fail. 256 IBM Tioli Monitoring for Business Integration: User s Guide

281 In addition, the SNMP agent uses the following run-time parameters from its configuration file: Polling delay Log file directory The polling delay affects the currentness of much of the InterChange Serer information that is reported to IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. This includes the following types of information: InterChange Serer state InterChange Serer memory utilization State of all collaborations Collaboration statistics State of all adapters Adapter statistics State of all adapter applications Making the polling delay too short increases processing time in the SNMP agent and the InterChange Serer to handle additional status requests. Making the polling delay too long affects the ability of IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer to report current information about the InterChange Serer. The default polling delay is 30 seconds. This is a reasonable alue to use until you gain more experience with the SNMP agent. Required authorization role wics_admin Before you begin Perform the following actions before you begin: 1. Hae the new port number, polling delay, log file directory, and serice name. 2. Make sure that the SNMP agent object exists. 3. The WICSnmpAgent is required. If the WICSnmpAgent is accidently deleted, recreate and recoer. See Discoering InterChange Serers on page 251 for how to recreate and recoer the WICSnmpAgent. When you finish You must restart the SNMP agent in order for the changes to take effect. If you did not choose to restart the SNMP agent, restart it before using Tioli functions with this SNMP agent. When you hae configured the SNMP Agent, you can run operational tasks against the InterChange Serer to determine its health and see its resources. You can also deploy the resource model to the InterChange Serer to monitor its health on an ongoing basis. Procedure You can perform this task from the Tioli desktop using an icon context menu. Initiate this task from the WICSnmpAgent icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Configure SNMP Agent task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Chapter 19. Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer 257

282 Steps: 1. Right-click the WICSnmpAgent icon. 2. Select Configuration Configure Agent to open the Configure SNMP Agent window. Additional information: The following fields contain current alues when the window opens: Polling Interal Port Number Log File Serice Name If these alues are acceptable, you do not need to run the task to make changes. Additional information: The Tioli software checks the port number and saes it internally when you open this window. 3. Type the number of seconds (2 4 digits) for the polling interal in the Polling Interal field. 4. Type the port number (3 6 digits) in the Port Number field. Additional information: The port number is the port oer which the SNMP agent communicates. Enter the port number as an integral alue between 100 and Type the path and name for the SNMP agent log file in the Log File field. Additional information: Type the path using forward slashes for both UNIX and Windows operating systems. The path name is stored in the configuration file with the correct style of slashes for the operating system on which it runs. Do not use spaces or special characters in this field for UNIX operating systems. 6. Type the name of the serice in the Serice Name field. Additional information: If running the SNMP agent as Windows serice, type the serice name as it was entered in the WebSphere InterChange Serer serice creation tool. 7. Select the Restart SNMP Agent check box for the changes to take effect. 8. Click Set and Execute to run the task. Setting SNMP Community Names Objectie To set the community names used by the SNMP agent. Background information The WebSphere InterChange Serer SNMP agent is the interface used by the Tioli management software to access information about an InterChange Serer and its resources. In order for the Tioli software to communicate with the SNMP agent for a specific InterChange Serer, you must proide both the Tioli software and the SNMP agent with the same set of read and write community names. Community names are SNMP codes that act as passwords for an application requesting serices of the SNMP agent. Read community names allow the calling application to retriee information from the SNMP agent. The Tioli software uses the read community name to get status and statistics about the ICS and its resources. Write community names allow the calling application to change 258 IBM Tioli Monitoring for Business Integration: User s Guide

283 information in the SNMP agent. The Tioli software uses write community names to start, stop, pause, and shut down InterChange Serer resources. The Tioli software is initially configured using the standard read and write community names of public and administrator, respectiely. If you are using different community names, change these default settings. Required authorization role wics_admin Before you begin Hae an existing community name that is authorized to make changes to the SNMP agent Hae the new read and write community names to be configured for Tioli software use. Ensure that the SNMP agent is running. When you finish Check the configuration by running the Check Status task for the InterChange Serer. Procedure You can perform this task from the Tioli desktop using an icon context menu. Initiate this task from a WICSnmpAgent icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Set SNMP Community Names task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click the WICSnmpAgent icon. 2. Select Configuration Set Community Names to open the Set SNMP Community Names window. 3. Complete the fields and options as follows: a. Type an existing write community name in the Authorized Community Name/Write Name field. Additional information: This name must be an existing community name with write permission to the SNMP agent. This write name is used to insert the new community names into the SNMP agent. b. Type the new read community name in the New Community Names/Read Name field. Additional information: The read name is used by the Tioli software when retrieing information from the SNMP agent. c. Type the new write community name in the New Community Names/Write Name field. Additional information: The write name is used by the Tioli software when inserting information into the SNMP agent. d. Click Set and Execute to run the task. Chapter 19. Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer 259

284 Discoering adapter agents 4. Check the task output to ensure that the new community names were successfully added. Objectie To define adapter agents to Tioli by creating WICSAdapterAgent objects through the adapter agents discoery process. Background information The discoer task identifies adapter agents by searching specified endpoints for adapter agent signature files that correspond to adapter agents in use in the InterChange Serer. These signature files are the startup scripts used to start the adapter agents. The names of the startup scripts differ for Windows and UNIX platforms. For Windows, startup scripts are determined by searching the All Users profile for adapter startup shortcuts. When shortcuts are found that match an adapter name and the InterChange Serer name, the adapter agent is discoered. For UNIX, startup scripts are determined by searching the file system for files named connector_manager. If this file is found, it is checked to make sure that it is associated with the current InterChange Serer. If so, searching continues for files named connector_manager_<adapter_name>, where the adapter_name is an adapter known to this InterChange Serer. If this file is found, the adapter agent is discoered. The installation directory is also dynamically determined by the discoer task. For a Windows endpoint, the installation directory is taken from the CROSSWORLDS enironment ariable. If this ariable is not defined, the task will not report any adapter agents for that machine. For a UNIX endpoint, the installation directory is deried from the location of connector_manager files found on the machine. When adapter agents are found, they are defined in Tioli as WICSAdapterAgent objects. These WICSAdapterAgent objects are created in the WICSerer policy region under which the discoer task is run. This task proides the following output: The set of adapter agents that were found and the characteristics of those serers Any endpoints that could not be searched because of error communicating with the endpoint Any errors in the object creation process Any adapter agents that were already defined to Tioli Required authorization role wics_admin Before you begin Identify the set of endpoints that will be checked for adapter agent installations. Determine how you will assign object locations for Tioli objects and hae the set of gateways used for this purpose. Refer to Understanding Tioli object locations on page 250 for an understanding of object locations. 260 IBM Tioli Monitoring for Business Integration: User s Guide

285 Ensure that the InterChange Serer for which you are discoering adapter agents is running. The InterChange Serer must be running in order for the task to obtain the set of adapters currently defined to the InterChange Serer. When you finish After you define the adapter agents, you can run tasks to query the adapter state, start the adapter, and stop the adapter. Procedure You can perform this procedure from the Tioli desktop using an icon context menu. Initiate the Discoer Adapter Agents task from the WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Discoer Adapter Agents task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click the WICSerer icon. 2. Select Configuration Discoer Adapter Agents. 3. Complete the fields and options in the window as follows: a. Select one or more endpoints from the Tioli Endpoints list. Additional Information: The list shows only the endpoints managed by this Tioli region. The task does not support discoery on endpoints in other Tioli regions. b. Select one managed node from the Object Host list. Additional Information: The WebSphere InterChange Serer Adapter Agent objects will be created on this managed node. If you select a specific managed node, all WebSphere InterChange Serer Adapter Agent objects will be created on that managed node. If you each WebSphere InterChange Serer Adapter Agent object will be created on the managed node currently sering as the gateway for the endpoint on which the adapter agent was found. 4. Click Set and Execute to run the task. Additional information: The task may run for seeral minutes. 5. Reiew the task output. Defining Adapter Agents manually Objectie To create objects that represent your adapter agents without using the discoery function. Background information Manual definition creates a WICSAdapterAgent object in Tioli based on information you proide. The create process alidates information you enter to ensure that the adapter agent exists. When adapter agents are added, they are defined in Tioli as WICSAdapterAgent objects. The WICSAdapterAgent object is created in the WICSerer policy region under which the create task is run. Chapter 19. Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer 261

286 Required authorization role wics_admin Before you begin Complete the following actions before you begin the procedure: Identify the endpoint on which the adapter agent is installed. Determine how you will assign object locations for Tioli objects and hae the set of gateways used for this purpose. Refer to Understanding Tioli object locations on page 250 for an understanding of object locations. Hae the following pieces of information aailable to complete the fields in the window: Adapter name Application name Adapter agent installation directory (UNIX only) When you finish Not applicable Procedure You can perform this procedure from the Tioli desktop. Steps: 1. Open the WICSerer policy region in which this adapter agent will be defined 2. Click Create WICSAdapterAgent from the menu to open the Create WICSAdapterAgent window. Figure 41. Create WICSAdapterAgent window 262 IBM Tioli Monitoring for Business Integration: User s Guide

287 3. Complete the fields and options in the Create WICSAdapterAgent window as follows: Additional information: Refer to the online help for more information. a. Type the adapter agent name in the Name field. b. Type the name of the application in the Application Name field. c. Click the endpoint in the Endpoint Name list. d. Click one managed node in the Object Host list. e. Do one of the following depending on your operating system: UNIX If the endpoint selected in step 3c is a UNIX endpoint, the Installation Directory field is enabled. Type the path to the installation directory. Windows If the endpoint selected in step 3c is a Windows endpoint, the Installation Directory field is disabled. The installation directory is deried from the CROSSWORLDS enironment ariable on the endpoint. f. Click Set and Execute to run the task. 4. Reiew the task output. Chapter 19. Setting up IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer 263

288 264 IBM Tioli Monitoring for Business Integration: User s Guide

289 Chapter 20. Viewing information related to InterChange Serers This chapter proides information about how to iew information related to InterChange Serers. Table 42 proides a list of goals for iewing information about InterChange Serers and related resources and components using IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. The table also tells where to locate information about the procedures for each goal. Table 42. Viewing information related to InterChange Serers Goal Check the status of InterChange Serers and resources. View information about the properties of InterChange Serers and adapter agents. Where to find procedures Checking status Viewing the properties of InterChange Serers on page 278 View a set of adapter controllers for an Interchange Serer. View a set of collaborations for an Interchange Serer. View information about IBM Tioli Monitoring for Business Integration: WebSphere MQ queue managers. View information about profiles for a WICSerer component Viewing adapter agent properties on page 287 Opening the Adapter Controllers window on page 293 Opening the Collaborations window on page 297 Viewing queue managers on page 267 Opening the profiles window and accessing operations for the profiles on page 268 Checking status Objectie To check the status of an InterChange Serer, one of its components, or one of resources. Background information The status of InterChange Serer components and resources is important to the proper functioning of the InterChange Serer. The InterChange Serer Status resource model automatically monitors the oerall health of the InterChange Serer, its components, and its resources. You can use the Check Status task to manually check on resource health. The Check Status task is a useful diagnostic tool if your InterChange Serer is not running properly. When you run the Check Status task from the task library, the input parameters are not set, so a full status check runs against the WebSphere InterChange Serer when the endpoint is a WICSerer object. When the task runs in the context of an adapter controller or collaboration, the parameters are set. Copyright IBM Corp

290 The leel of information reported depends on the resource for which you check status. Table 43 proides a description of the information that the task reports for each type of resource. Table 43. Status information reported for each type of WebSphere InterChange Serer resource Resource WICSerer object Status information reported State of the InterChange Serer: If running, a detailed report showing all collaborations and adapter controllers is displayed. The SNMP agent must be running in order to check the InterChange Serer status and to get the detailed report. WICSnmpAgent WICSAdapterAgent adapter controller collaboration State of the SNMP agent State of the adapter agent State and statistical information about the adapter controller. The SNMP agent and the InterChange Serer must be running in order to perform this function. State and statistical information about the collaboration. The SNMP agent and the InterChange Serer must be running in order to perform this function. For a WICSerer, WICSnmpAgent, or WICSAdapterAgent object, the icon state will also be changed to reflect to current state of the component. Required authorization role wics_user Before you begin Not applicable When you finish Not applicable Procedure You can perform this procedure from the Tioli desktop using an icon context menu, a task library, or a window. Icon context menu: WICSerer WICSnmpAgent WICSAdapterAgent Initiate the Check Status task from one of the following icons: For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Steps: 1. Right-click an icon. 2. Select Operation Check Status. 266 IBM Tioli Monitoring for Business Integration: User s Guide

291 3. Reiew the task output to see the current status and statistical information. Task library: library. Run the Check Status task from the WICS Operational Tasks task For information about running a task from a task library, see Task library on page 145 steps. Window: Run the Check Status task from the Adapter Controllers window or the Collaborations window. For information about running a task from a window menu, see IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer windows on page 153. Steps: Viewing queue managers 1. Open the Adapter Controllers window or the Collaborations window using one of the following procedures: Opening the Adapter Controllers window on page 293 Opening the Collaborations window on page Select an adapter controller or a collaboration from any of the lists. 3. Select Action Check Status from the menu bar to check the status of the selected resource. For more information about the Check Status task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Objectie To iew the IBM Tioli Monitoring for Business Integration: WebSphere MQ queue manager associated with a WICSerer component. You can open and act on this queue manager as if you accessed it directly from the IBM Tioli Monitoring for Business Integration: WebSphere MQ software. Background information An InterChange Serer requires a message deliery facility. The IBM WebSphere MQ product is often used for this purpose. Problems in a WebSphere MQ queue manager can affect the operation and performance of the InterChange Serer. If you hae IBM Tioli Monitoring for Business Integration: WebSphere MQ installed, you can easily manage the queue manager used by the InterChange Serer. You can configure an InterChange Serer to use WebSphere MQ as its queueing facility. You can determine if the InterChange Serer is using WebSphere MQ for this purpose by iewing the WICSerer properties. Refer to Viewing the properties of InterChange Serers on page 278 for details on running this procedure. When diagnosing InterChange Serer problems, it might be useful to check the state of the associated MQ queue manager. This can be done when the IBM Tioli Monitoring for Business Integration: WebSphere MQ software is installed. If the queue manager is being managed, there will be an MqM_QMgr object in Tioli named for the queue manager used by the InterChange Serer. This task allows you to easily access that queue manager object from a WICSerer object. Chapter 20. Viewing information related to InterChange Serers 267

292 Required authorization role wics_admin To take action on the queue manager object, you will also need IBM Tioli Monitoring for Business Integration: WebSphere MQ authorization roles. Before you begin If you want to use this facility, you will need to install IBM Tioli Monitoring for Business Integration: WebSphere MQ and hae it manage the queue manager used by this InterChange Serer. When you finish You can take actions on this queue manager object. Refer to other Tioli documentation for taking actions on the queue manager object. Procedure You can perform this procedure from the Tioli desktop using an icon context menu. Initiate this task from a WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Open Queue Manager task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click the WICSerer icon. 2. Select Open Queue Manager to open the MqM_QMgr object for the queue manager associated with this InterChange Serer. Additional information: When the task completes, a window with the MqM_QMgr object for the queue manager associated with this InterChange Serer opens. If the MqM_QMgr object does not exist, you will see a message identifying the queue manager object name that could not be found. Opening the profiles window and accessing operations for the profiles Objectie To iew the IBM Tioli Monitoring profiles that were distributed to a WICSerer object. You can open and modify these profiles in the same way that you manage any Tioli profile. The actions you take on these profiles affect only this WICSerer object. Background information The profiles distributed to a WICSerer object can only contain IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer resource models. By default, the WICS Serer Status profile is aailable for distribution to WICSerer objects. This profile contains the InterChange Serer Status resource model. Once this profile is distributed to a WICSerer object, it will appear in this window. If other profiles are distributed to this WICSerer object, they will also appear in this window. Required authorization role wics_admin 268 IBM Tioli Monitoring for Business Integration: User s Guide

293 Before you begin Not applicable. When you finish You can take actions on the displayed profiles just as you can for any Tioli profile. You can open the profiles, edit the profiles, and distribute the profiles from this window. Refer to other Tioli documentation for taking actions on profiles and the resource models that they contain. Procedure You can perform this procedure from the Tioli desktop using an icon context menu. Initiate this task from a WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Opening the profiles window task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click the WICSerer icon. 2. Select Monitoring Profiles Open to open a list of profiles. Additional information: A window with a list of all profiles that hae been distributed to this WICSerer object opens. Chapter 20. Viewing information related to InterChange Serers 269

294 270 IBM Tioli Monitoring for Business Integration: User s Guide

295 Chapter 21. Working with SNMP agents This chapter describes how to work with SNMP agents using IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. Table 44 proides a list of goals for working with SNMP agents. The table also tells where to locate information about the procedures for each goal. Table 44. Working with SNMP agents Goal View information about an SNMP agent. Where to find procedures Viewing SNMP agent properties Checking status on page 265 Retrieing SNMP agent logs on page 272 Retrieing Tioli log files on page 306 Start and stop an SNMP agent. Starting SNMP agents on page 273 Stopping SNMP agents on page 274 Reconfigure an SNMP agent Configuring SNMP Agents on page 256 Setting SNMP Community Names on page 258 Changing the SNMP host on page 275 Reset the Tioli Endpoint reference for an object. Reestablishing Tioli Endpoints on page 309 Viewing SNMP agent properties Objectie To iew properties that are associated with an SNMP agent. The properties include both characteristics of the SNMP agent and of the Tioli management for the resource. Background information The SNMP agent properties are established when the WICSnmpAgent is created in Tioli. You can change selected characteristics of the SNMP agent after creating it. Required authorization role wics_user Before you begin Not applicable When you finish You can change the following alues: SNMP agent port number (See Configuring SNMP Agents on page 256) Copyright IBM Corp

296 SNMP agent host name (See Changing the SNMP host on page 275) SNMP community names (See Setting SNMP Community Names on page 258) Procedure You can run this task from the Tioli desktop using an icon context menu. Initiate this task from a WICSnmpAgent icon. For information about running a task from an icon, see Icon context menu on page 148 steps. For more information about the View SNMP agent properties task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click the WICSerer icon. 2. Select Open Agents. 3. Right-click the WICSnmpAgent icon. 4. Select Operations Properties. 5. Reiew the task output to see the following information when the task completes: InterChange Serer name InterChange Serer host name SNMP agent port number SNMP agent host name SNMP agent installation directory SNMP agent serice name Tioli endpoint on which the SNMP agent is running Tioli managed node on which the WICSnmpAgent object resides Log file identifier Retrieing SNMP agent logs Objectie To retriee the log file for an SNMP agent. Background information SNMP agent log files record SNMP agent internal processing. The information in these files is useful for debugging SNMP agent problems. These files are also useful for diagnosing SNMP agent start up problems. The log files can be large. This task reports the last 500 lines of output of a file that contains more than 500 lines of information. If a file contains 500 or fewer lines of information the task reports the entire contents of the file. Required authorization role wics_user Before you begin Not applicable 272 IBM Tioli Monitoring for Business Integration: User s Guide

297 When you finish Not applicable Procedure You can perform this task from the Tioli desktop using an icon context menu. Initiate this task from a WICSnmpAgent icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Retriee SNMP Agent logs task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: Starting SNMP agents 1. Right-click the WICSnmpAgent icon. 2. Select Diagnostics SNMP Agent Log. 3. Reiew the task output to see the log file contents when the task completes. Objectie To start an SNMP agent. Background information The SNMP agent is the component of an InterChange Serer that proides the interface for system management products. The SNMP agent for an InterChange Serer must be running in order for the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer management and monitoring functions to work. See Understanding the SNMP Agent on page 244 for more information about the SNMP agent. Required authorization role wics_admin Before you begin Not applicable When you finish If the SNMP agent did not start immediately, wait about one minute and run Check Status for the SNMP agent to check the current status. Procedure You can perform this procedure from the Tioli desktop using an icon context menu or a task library. Icon context menu: icon. Initiate the Start SNMP Agent task from a WICSnmpAgent For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Steps: 1. Right-click a WICSnmpAgent icon. Chapter 21. Working with SNMP agents 273

298 2. Select Operation Start. 3. Reiew the task output to ensure that the SNMP agent started. Additional information: The icon state will also be changed to reflect to current state of the component. Task library: task library. Run the Start SNMP Agent task from the WICS Operational Tasks Stopping SNMP agents For information about running a task from a task library, see Task library on page 145 steps. For more information about the Start SNMP Agent task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Objectie To stop an SNMP agent. Background information The SNMP agent is the component of an InterChange Serer that proides the interface for system management products. The SNMP agent for an InterChange Serer must be running in order for the IBM Tioli Monitoring for Business Integration WebSphere InterChange Serer management and monitoring functions to work. Required authorization role wics_admin Before you begin In order to use this task, you must hae used the Start SNMP Agent task to start the SNMP agent. When you finish If the SNMP agent did not stop immediately, wait about one minute and run Check Status for the SNMP agent to check the current status. Procedure You can perform this procedure from the Tioli desktop using an icon context menu or a task library. Icon context menu: icon. Initiate the Stop SNMP Agent task from a WICSnmpAgent For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Steps: 1. Right-click a WICSnmpAgent icon. 2. Select Operation Stop. 3. Click Yes on the confirmation window to confirm that you want to stop the InterChange Serer. 4. Reiew the task output to ensure that the SNMP agent stopped. Additional information: The icon state will also be changed to reflect to current state of the component. 274 IBM Tioli Monitoring for Business Integration: User s Guide

299 Task library: task library. Run the Stop SNMP Agent task from the WICS Operational Tasks Changing the SNMP host For information about running a task from a task library, see Task library on page 145 steps. For more information about the Stop SNMP Agent task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Objectie To change the host on which the SNMP agent is running. Background information The WICSnmpAgent object is created automatically when the WICSerer object with which it is associated is created. The SNMP agent host name is assigned as the host name on which the InterChange Serer is running. SNMP architecture allows the SNMP agent and the application it manages to be on different machines. If your configuration has these applications on different machines, then you must change the Tioli definition for the SNMP agent host. This task will check the new host machine for an installation of a WebSphere InterChange Serer SNMP agent. The host name change is allowed only if an SNMP agent is installed on the new machine. Required authorization role wics_admin Before you begin Hae the new alue for the host name that you wish to change. When you finish Changing the SNMP agent host has the effect of changing the SNMP agent used for this InterChange Serer. Since seeral parameters are associated with the SNMP agent configuration, you must check and update these other parameters. Run the following tasks after completing this task: Configuring the SNMP Agent: Run this task to check and update the port number and polling delay. Setting SNMP Community Names Run this task to ensure that you are using the correct read and write community names for this SNMP agent and InterChange Serer. Procedure You can perform this task from the Tioli desktop using an icon context menu. Initiate this task from a WICSnmpAgent icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Change SNMP host task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click the WICSnmpAgent icon. Chapter 21. Working with SNMP agents 275

300 2. Select Configuration Change Agent Host. 3. Select the Tioli endpoint on which the SNMP agent is running in the Endpoint Name field. Additional information: This field is required. 4. If you hae a UNIX operating system: Type the name of the SNMP agent installation directory on the remote machine in the SNMP Agent Directories/Installation Directory field Additional information: This field is only aailable on UNIX operating systems and is required for SNMP agents. The field is enabled or disabled based on the selection you make in the Endpoint Name list. If you hae a Windows operating system, the CROSSWORLDS enironment ariable on the remote machine obtains the installation directory. 5. Click Set and Execute to change the SNMP agent host. 276 IBM Tioli Monitoring for Business Integration: User s Guide

301 Chapter 22. Working with InterChange Serers This chapter describes how to work with InterChange Serers using IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. Table 45 proides a list of goals for working with IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. The table also tells where to locate information about the procedures for each goal. Table 45. Working with InterChange Serers Goal View information about InterChange Serers and resources. Where to find procedures Viewing the properties of InterChange Serers on page 278 Checking status on page 265 Opening the Adapter Controllers window on page 293 Opening the Collaborations window on page 297 Opening a list of InterChange Serer log or trace files on page 303 Opening the Tioli Log File window on page 305 Viewing queue managers on page 267 Start and stop an InterChange Serer. Control monitoring. Reconfigure an InterChange Serer. Opening the profiles window and accessing operations for the profiles on page 268 Starting InterChange Serers on page 279 Stopping InterChange Serers on page 280 Enabling resource models on page 281 Disabling resource models on page 282 Changing configuration files on page 283 Changing hosts on page 284 Reset the Tioli Endpoint reference for an object. Setting data proider trace leels on page 310 Reestablishing Tioli Endpoints on page 309 Copyright IBM Corp

302 Viewing the properties of InterChange Serers Objectie To iew properties that are associated with an InterChange Serer. The properties include both characteristics of the InterChange Serer and of the Tioli management for the resource. Background information The InterChange Serer properties are established when a WICSerer is created in Tioli. Selected characteristics of the InterChange Serer can be changed after creation. Required authorization role wics_user Before you begin Not applicable When you finish You can change the following alues: Configuration file name (See Changing configuration files on page 283) Configuration file directory (See Changing configuration files on page 283) Database host name (See Changing hosts on page 284) MQ queue manager host name (See Changing hosts on page 284) Procedure You can perform this task from the Tioli desktop using an icon context menu. Initiate this task from a WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the View InterChange Serer properties task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click the WICSerer icon. 2. Select Operation Properties. 3. Reiew the task output to see the following information when the task completes: InterChange Serer name InterChange Serer host name InterChange Serer installation directory InterChange Serer administrator ID Configuration file name Configuration file directory Database type Database host name Eents database name Transactions database name 278 IBM Tioli Monitoring for Business Integration: User s Guide

303 Repository database name Queue manager type MQ queue manager name MQ queue manager host name Tioli endpoint on which the InterChange Serer is running Tioli managed node on which the WICSerer object resides Log file identifier Starting InterChange Serers Objectie To start an InterChange Serer. Background information The InterChange Serer is the main processing facility of the WebSphere InterChange Serer. It must be up to support e-business application integration. The InterChange Serer must also be running in order to perform the following IBM Tioli Monitoring for Business Integration WebSphere InterChange Serer functions: Discoering adapter agents Working with adapter controllers Working with collaborations In addition to starting the InterChange Serer, this task also changes the icon state to reflect to current state of the component. Required authorization role wics_admin Before you begin Not applicable When you finish If the InterChange Serer did not start immediately, wait about one minute and run the Check Status task for the InterChange Serer to check the current status. Procedure You can perform this procedure from the Tioli desktop using an icon context menu or a task library. Icon context menu: Initiate this task from a WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Steps: 1. Right-click the WICSerer icon. 2. Select Operation Start. 3. Reiew the task output to ensure that the InterChange Serer started. Task library: Run the Start InterChange Serer task from the WICS Operational Tasks task library. Chapter 22. Working with InterChange Serers 279

304 For information about running a task from a task library, see Task library on page 145 steps. 1. Open the Monitoring for WebSphere ICS policy region. 2. Open the WICS Operational Tasks task library. 3. Select and run the Start InterChange Serer task. 4. Select one or more WICSerer endpoints to which you want to run the task, and run the task. For more information about the Start InterChange Serer task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Stopping InterChange Serers Objectie To stop an InterChange Serer. Background information The InterChange Serer is the main processing facility of the WebSphere InterChange Serer. It must be up to support e-business application integration. The InterChange Serer must also be running in order to perform the following IBM Tioli Monitoring for Business Integration WebSphere InterChange Serer functions: Discoering adapter agents Working with adapter controllers Working with collaborations Stopping of the InterChange Serer is performed using the SNMP agent. The SNMP agent must be running in order for this task to work. In addition to stopping the InterChange Serer, this task also changes the icon state to reflect to current state of the component. Required authorization role wics_admin Before you begin Ensure that the SNMP agent for this InterChange Serer is running. When you finish If the InterChange Serer did not stop immediately, wait about one minute and run the Check Status task for the InterChange Serer to check the current status. Procedure You can perform this procedure from the Tioli desktop using an icon context menu or a task library. Icon context menu: Initiate this task from the WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Steps: 1. Right-click the WICSerer icon. 2. Select Operation Stop. 280 IBM Tioli Monitoring for Business Integration: User s Guide

305 Enabling resource models 3. Click Yes on the confirmation window to confirm that the InterChange Serer should be stopped. 4. Reiew the task output to ensure that the InterChange Serer stopped. Task library: Run the Stop InterChange Serer task from the WICS Operational Tasks task library. For information about running a task from a task library, see Task library on page Open the Monitoring for WebSphere ICS policy region. 2. Open the WICS Operational Tasks task library. 3. Select and run the Stop InterChange Serer task. 4. Select one or more WICSerer endpoints to which you want to run the task, and run the task. Additional information: A confirmation window is not displayed when you use this procedure For more information about the Stop InterChange Serer task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Objectie To enable all resource models distributed to a WICSerer object. Background information Profiles are used to distribute resource models to a WICSerer. By default, the WICS Serer Status profile contains the InterChange Serer Status resource model. If you hae stopped the monitoring of an InterChange Serer using the Disabling resource models on page 282 task, you must enable the resource models in order to resume monitoring the InterChange Serer. Enabling resource models is an efficient way to start or restart monitoring. Required authorization role wics_admin Before you begin Ensure that monitoring of the InterChange Serer should be reactiated. When you finish Not applicable Procedure You can perform this procedure from the Tioli desktop using an icon context menu. Initiate this task from a WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Enable resource model task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Chapter 22. Working with InterChange Serers 281

306 Steps: Disabling resource models 1. Right-click the WICSerer icon. 2. Select Monitoring Profiles Enable All. Additional information: When the task completes, all resource models distributed to this WICSerer object are enabled. Objectie To disable all resource models distributed to a WICSerer object. Background information Profiles are used to distribute resource models to a WICSerer. By default, the WICS Serer Status profile contains the WICS InterChange Serer Status resource model. If you are planning on shutting down an InterChange Serer for serer maintenance or off-shift reasons, you may want to disable the Tioli monitoring of that InterChange Serer while the InterChange Serer is offline, to preent reporting of error eents. Disabling resource models is an efficient way to stop monitoring when you do not need it. Required authorization role wics_admin Before you begin Ensure that monitoring of the InterChange Serer will not be necessary while the resource models are disabled. When you finish When the InterChange Serer is restarted, enable the resource models. See Enabling resource models on page 281 or run the Enabling Resource Models task to enable and reactiate all resource models distributed to this WICSerer object. Procedure You can perform this procedure from the Tioli desktop using an icon context menu. You can initiate this task from a WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Disable resource model task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click a WICSerer icon. 2. Select Monitoring Profiles Disable All. Additional information: When the task completes, all resource models distributed to this WICSerer object will be disabled. 282 IBM Tioli Monitoring for Business Integration: User s Guide

307 Changing configuration files Objectie To change the Tioli information about the configuration file that is associated with an InterChange Serer. Background information Information about an InterChange Serer is deried from its configuration file. You may hae multiple InterChange Serer configuration files on a machine, perhaps to support migration and fallback options. When the discoer task runs, it selects a configuration file based on the InterChange Serer name and time of last update. If the selected configuration file was not the correct one, or if a new configuration file was added later, you can update the configuration file information in the Tioli region without the need to delete and recreate the object. Changing the configuration file information ensures that the latest information about the MQ queue manager and the database manager is aailable for reporting in resource model eents. An InterChange Serer can be started with different configuration files; howeer, the configuration file is defined to Tioli when the object was discoered or created. If the name or location of the configuration file is changed after the object was defined to Tioli, the Tioli management functions may no longer work. To re-enable the Tioli management functions, it is necessary to update the configuration file information in Tioli. This task allows you to make this change. When a new configuration file is specified, the task ensures that the file exists before accepting the new configuration file. If the file exists, InterChange Serer properties stored in Tioli are updated. Required authorization role wics_admin Before you begin Not applicable When you finish Use the Properties function to iew the updated object properties. Procedure You can perform this task from the Tioli desktop using an icon context menu. Initiate this task from a WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Change configuration file task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click the WICSerer icon. 2. Select Configuration Change Configuration File. Additional information: The Change Configuration File window opens showing the following information: The current name of the configuration file is in the InterChange Serer/ Configuration File field. Chapter 22. Working with InterChange Serers 283

308 Changing hosts The current directory path for the current configuration file is in the InterChange Serer/Configuration File Directory field. 3. If you want to change the configuration file name, type the new configuration file name in the InterChange Serer/ Configuration File field. 4. If you want to change the directory path, type the new directory path in the InterChange Serer/Configuration File Directory field. 5. Click Set and Execute to change the configuration file alues. Objectie To change the host names for the database manager and the MQ queue manager. Background information An InterChange Serer is dependent on external middleware for its processing. This middleware consists of MQ queue managers and database managers. All of the MQ queue manager and most of the database manager information is obtained from the InterChange Serer configuration file. The database manager host name cannot be determined from the configuration file, but defaults to the host name on which the InterChange Serer runs. This information is used in eent reporting to assist in problem correlation, and it is used to hot-link to the MQ queue manager object. If the database manager host name is not correct, and you want this information reported correctly in your eents, you can enter the correct host name into the software. The MQ queue manager information, in addition to eent reporting, is used to hot-link to the IBM Tioli Monitoring for Business Integration: WebSphere MQ queue manager object. If the queue manager has been moed to another host, you can update IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer with the new host name using this procedure. These InterChange Serer properties are established when a WICSerer is created in Tioli. The MQ queue manager host name is read from the InterChange Serer configuration file. The database manager host name is assigned as the host name on which the InterChange Serer is running. These alues are proided as attributes in selected resource model eents to facilitate eent correlation. The MQ queue manager host name is also used in constructing the Monitoring for WebSphere MQ MqM_QMgr instance name. You may need to change either or both of these alues if the InterChange Serer configuration has changed. Required authorization role wics_admin Before you begin Hae the new alues for host names that you wish to change. When you finish When the task completes, check the assigned alue by iewing the InterChange Serer properties. 284 IBM Tioli Monitoring for Business Integration: User s Guide

309 Procedure You can perform this procedure from the Tioli desktop using an icon context menu. Initiate this task from a WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Change host task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click a WICSerer icon. 2. Select Configuration Change Hosts. Additional information: The Change Hosts window opens showing the following information: The current name of the database host is in the Database Host Name field. The current name of the MQ host is in the MQ Host Name field. 3. If you want to change the database host name, type the new database host name in the Database Host Name field. 4. If you want to change the name of the MQ host, type the name of the MQ host name in the MQ Host Name field. 5. Click Set and Execute to change the host name alues. Chapter 22. Working with InterChange Serers 285

310 286 IBM Tioli Monitoring for Business Integration: User s Guide

311 Chapter 23. Working with adapter agents This chapter describes how to work with adapter agents using IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. Table 46 proides a list of goals for working with adapter agents. The table also tells where to locate information about the procedures for each goal. Table 46. Working with adapter agents Goal View information about adapter agents. Where to find procedures Viewing adapter agent properties Checking status on page 265 Retrieing adapter agent logs on page 288 Retrieing Tioli log files on page 306 Start and stop an adapter agent. Starting adapter agents on page 289 Reset the Tioli Endpoint reference for an object. Stopping adapter agents on page 290 Reestablishing Tioli Endpoints on page 309 Viewing adapter agent properties Objectie To iew properties that are associated with an adapter agent. The properties include both characteristics of the adapter agent and of the Tioli management for the resource. Background information The adapter agent properties are established when a WICSAdapterAgent is created in Tioli. The characteristics of the adapter agent cannot be changed after creation. Required authorization role wics_user Before you begin Not applicable When you finish Not applicable. Procedure You can perform this procedure from the Tioli desktop using an icon context menu. Initiate this task from a WICSAdapterAgent icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Copyright IBM Corp

312 For more information about the View adapter agent properties task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click the WICSerer icon. 2. Select Open Agents. 3. Right-click the WICSAdapterAgent icon. 4. Select Operation Properties. 5. Reiew the task output to see the following information when the task completes: InterChange Serer name InterChange Serer host name Adapter agent name Application name Adapter agent host name Adapter agent installation directory Tioli endpoint on which the adapter agent is running Tioli managed node on which the WICSAdapterAgent object resides Log file identifier Retrieing adapter agent logs Objectie To retriee the log file for an adapter agent. Background information Adapter agent log files are used to record adapter agent internal processing. The information in these files is useful for debugging adapter agent problems. These files are also useful for diagnosing adapter agent start up problems. Configuration information for an adapter agent log file is stored in the InterChange Serer. The Tioli software does not hae access to this configuration information. Note: This task is only able to retriee adapter agent log files on UNIX systems. These log files are the default log files. The log files can be large. This task reports the last 500 lines of output of a file that contains more than 500 lines of information. If a file contains 500 or fewer lines of information the task reports the entire contents of the file. Required authorization role wics_user Before you begin Not applicable When you finish Not applicable Procedure You can perform this procedure from the Tioli desktop using an icon context menu. 288 IBM Tioli Monitoring for Business Integration: User s Guide

313 Initiate this task from a WICSAdapterAgent icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Retriee Adapter Agent logs task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: Starting adapter agents 1. Right-click the WICSAdapterAgent icon. 2. Select Diagnostics Adapter Agent Log. 3. Reiew the task output to see the log file contents when the task completes. Objectie To start an adapter agent. Background information Adapter agents are the components of an InterChange Serer that interact directly with an e-business application. The adapter agents generally run on the same machine as the application. The adapter agent, the adapter controller, and the application must all be running in order for an InterChange Serer to communicate with the application. Required authorization role wics_admin Before you begin Not applicable When you finish If the adapter agent did not start immediately, wait about one minute and run the Check Status task for the adapter agent to check the current status. Procedure You can perform this procedure from the Tioli desktop using an icon context menu or a task library. Icon context menu: Initiate this task from a WICSAdapterAgent icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Steps: 1. Right-click the WICSAdapterAgent icon. 2. Select Operation Start. 3. Reiew the task output to ensure that the adapter agent started. Additional information: The icon state changes to reflect to current state of the component. Task library: task library. Run the Start Adapter Agent task from the WICS Operational Tasks Chapter 23. Working with adapter agents 289

314 Stopping adapter agents For information about running a task from a task library, see Task library on page 145 steps. 1. Open the Monitoring for WebSphere ICS policy region. 2. Open the WICS Operational Tasks task library. 3. Select and run the Start Adapter Agent task. 4. Select one or more WICS Adapter Agent endpoints to which you want to run the task. 5. Click Set & Execute to run the task. For more information about the Start Adapter Agent task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Objectie To stop an adapter agent. Background information Adapter agents are the components of an InterChange Serer that interact directly with an e-business application. The adapter agents generally run on the same machine as the application. The adapter agent, the adapter controller, and the application must all be running in order for an InterChange Serer to communicate with the application. Required authorization role wics_admin Before you begin In order to use this task, you must hae used the Start Adapter Agent task to start the adapter agent. When you finish If the adapter agent did not stop immediately, wait about one minute and run the Check Status task for the adapter agent to check the current status. Procedure You can perform this procedure from the Tioli desktop using an icon context menu or a task library. Icon context menu: Initiate this task from a WICSAdapterAgent icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Steps: 1. Right-click the WICSAdapterAgent icon. 2. Select Operation Stop. 3. Reiew the task output to ensure that the adapter agent stopped. Additional information: The icon state changes to reflect to current state of the component. Task library: task library. Run the Stop Adapter Agent task from the WICS Operational Tasks 290 IBM Tioli Monitoring for Business Integration: User s Guide

315 For information about running a task from a task library, see Task library on page 145 steps. 1. Open the Monitoring for WebSphere ICS policy region. 2. Open the WICS Operational Tasks task library. 3. Select and run the Stop Adapter Agent task. 4. Select one or more WICSAdapterAgent endpoints to which you want to run the task. 5. Click Set & Execute to run the task. For more information about the Stop Adapter Agent task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Chapter 23. Working with adapter agents 291

316 292 IBM Tioli Monitoring for Business Integration: User s Guide

317 Chapter 24. Working with adapter controllers and collaborations This chapter describes how to operate and use the IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer interface for displaying, starting, and stopping adapter controllers and collaborations. The software obtains these resources dynamically from the InterChange Serer and displays them in a window so you can use them to monitor and manage WebSphere InterChange Serer resources. Table 47 proides a list of goals for working with adapter controllers and collaborations. The table also tells where to locate information about the procedures for each goal. Table 47. Working with adapter controllers and collaborations Goal View information about adapter controllers. Where to find procedures Opening the Adapter Controllers window Control adapter controllers. Checking status on page 265 Starting adapter controllers on page 295 Pausing adapter controllers on page 296 View information about collaborations. Stopping adapter controllers on page 297 Opening the Collaborations window on page 297 Checking status on page 265 Control collaborations. Starting collaborations on page 299 Pausing collaborations on page 300 Stopping collaborations on page 301 Shutting down collaborations on page 302 Opening the Adapter Controllers window Objectie To iew the set of adapter controllers that are defined in an InterChange Serer, and to access the operations that you can perform on these resources. Background information Adapters are one of the resources managed by an InterChange Serer. An adapter consists of an adapter controller and an adapter agent. The adapter controllers run within the InterChange Serer. The adapter agents run on the operating system with the business application. You iew and manage the two components Copyright IBM Corp

318 separately, though both adapter controllers and adapter agents must be running in order for the InterChange Serer to support application integration. The Adapter Controllers window contains a list of the adapter controllers in each possible state for an InterChange Serer as shown in Figure 42. Figure 42. Adapter Controllers window Adapter controllers can be in one of the following states: running The adapter controller is working normally. pausing or stopping The adapter controller is in the process of going to the paused or stopped state. The adapter controller must reach the paused or stopped state before you can take further action on it. paused or stopped The adapter controller is in the paused or stopped state. While in either of these states, the adapter controller cannot process application messages. To determine the current state of the adapter controller, run the Check Status task for the adapter controller. Required authorization role wics_admin Before you begin Ensure that the InterChange Serer is running. 294 IBM Tioli Monitoring for Business Integration: User s Guide

319 When you finish Manage the adapter controllers using the menu bar for the Adapter Controllers window you just opened. You can perform the following actions on adapter controllers: Check Status (See Checking status on page 265 for details on running this procedure). Start (See Starting adapter controllers for details on running this procedure). Pause (See Pausing adapter controllers on page 296 for details on running this procedure). Stop (See Stopping adapter controllers on page 297 for details on running this procedure). Procedure You can perform this procedure from the Tioli desktop using an icon context menu. Initiate this task from a WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Open Adapter Controllers window task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click the WICSerer icon. Starting adapter controllers 2. Select Open Adapter Controllers to display the name and status of the adapter controllers currently defined in the InterChange Serer. Additional information: When the task completes, a window opens showing the adapter controllers currently defined in the InterChange Serer. The window has three sections that show the status of the adapter controllers. Objectie To start a selected adapter controller. Background information Adapter controllers are one of the resources managed by an InterChange Serer. Adapter controllers proide the communication control facility between the InterChange Serer and the business application. Required authorization role wics_admin Before you begin Open the Adapter Controllers window as described in Opening the Adapter Controllers window on page 293. When you finish If the adapter controller did not start immediately, wait about one minute and run the Check Status task for the adapter controller to check the current status. Chapter 24. Working with adapter controllers and collaborations 295

320 Procedure You can perform this procedure from the Tioli desktop using the Adapter Controllers window. For information about running a task from a window menu, see IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer windows on page 153 steps. For more information about the Start Adapter Controllers task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: Pausing adapter controllers 1. Select an adapter controller from the Paused/Stopped Adapter Controllers list. 2. Select Action Start from the menu bar to start the adapter controller. Additional information: The window does not automatically update the adapter controller lists based on their latest state. 3. Reiew the task output to ensure that the adapter controller started. 4. Repeat Steps 1 3 until you hae started all desired adapter controllers. 5. Select Action Refresh List from the menu bar to refresh the window. Objectie To pause a selected adapter controller. Background information Adapter controllers are one of the resources managed by an InterChange Serer. Adapter controllers proide the communication control facility between the InterChange Serer and the business application. Required authorization role wics_admin Before you begin Open the Adapter Controllers window as described in Opening the Adapter Controllers window on page 293. When you finish If the adapter controller did not pause immediately, wait about one minute and run the Check Status for task the adapter controller to check the current status. Procedure You can perform this procedure from the Tioli desktop using a Adapter Controllers window. For information about running a task from a window menu, see IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer windows on page 153 steps. For more information about the Pause Adapter Controller task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Select an adapter controller from the Running Adapter Controllers list. 2. Select Action Pause from the menu bar to pause the adapter controller. 296 IBM Tioli Monitoring for Business Integration: User s Guide

321 Stopping adapter controllers Additional information: The window does not automatically update the adapter controller lists based on their latest state. 3. Reiew the task output to ensure that the adapter controller paused. 4. Repeat Steps 1 3 until you hae paused all desired adapter controllers. 5. Select Action Refresh List from the menu bar to refresh the window. Objectie To stop a selected adapter controller. Background information Adapter controllers are one of the resources managed by an InterChange Serer. Adapter controllers proide the communication control facility between the InterChange Serer and the business application. Required authorization role wics_admin Before you begin Open the Adapter Controllers window as described in Opening the Adapter Controllers window on page 293. When you finish If the adapter controller did not stop immediately, wait about one minute and run the Check Status task for the adapter controller to check the current status. Procedure You can perform this procedure from the Tioli desktop using a window. Initiate this task from the Adapter Controllers window. For information about running a task from a window menu, see IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer windows on page 153 For more information about the Stop Adapter Controllers task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Select an adapter controller from the Running Adapter Controllers list in the Adapter Controllers window. 2. Select Action Stop from the menu bar to stop the adapter controller. Additional information: The window does not automatically update the adapter controller lists based on their latest state. 3. Reiew the task output to ensure that the adapter controller stopped. 4. Repeat Steps 1 3 until you hae stopped all desired adapter controllers. 5. Select Action Refresh List from the menu bar to refresh the window. Opening the Collaborations window Objectie To iew the set of collaborations, that are defined in an InterChange Serer, and to access the operations that you can perform on these resources. Chapter 24. Working with adapter controllers and collaborations 297

322 Background information Collaborations are one of the resources managed by an InterChange Serer. Collaborations proide the business control logic between e-business applications. The Collaborations window contains a list of the collaborations in each possible state for an InterChange Serer as shown in Figure 43. Figure 43. Collaborations window Collaborations can be in one of the following states: running The collaboration is working normally. pausing or stopping The collaboration is in the process of going to the paused or stopped state. The collaboration must reach the paused or stopped state before you can take further action on it. paused or stopped The collaboration is in the paused or stopped state. While in either of these states, the collaboration cannot process application messages. To determine the current state of the collaboration, run the Check Status task for the collaboration. Required authorization role wics_admin Before you begin Ensure that the InterChange Serer is running. 298 IBM Tioli Monitoring for Business Integration: User s Guide

323 When you finish Manage the collaborations using the menu bar for the Collaborations window you just opened. You can perform the following actions on collaborations: Check Status (See Checking status on page 265 for details on running this procedure). Start (See Starting collaborations for details on running this procedure). Pause (See Pausing collaborations on page 300 for details on running this procedure). Stop (See Stopping collaborations on page 301 for details on running this procedure). Shut Down Collaborations (See Shutting down collaborations on page 302 for details on running this procedure). Procedure Initiate this task from a WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Open Collaborations task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: Starting collaborations 1. Right-click the WICSerer icon. 2. Select Open Collaborations to display the name and status of the collaborations currently defined in the InterChange Serer. Additional information: When the task completes, a window opens showing the collaboration resources currently defined in the InterChange Serer. The window has three sections that show the status of the collaborations. Objectie To start a selected collaboration. Background information Collaborations are one of the processing resources managed by an InterChange Serer. Collaborations proide the business control logic between e-business applications. Required authorization role wics_admin Before you begin Open the Collaborations window as described in Opening the Collaborations window on page 297. When you finish If the collaboration did not start immediately, wait about one minute and run the Check Status task for the collaboration to check the current status. Procedure You can perform this procedure from the Tioli desktop using the Collaborations window. Chapter 24. Working with adapter controllers and collaborations 299

324 For information about running a task from a window menu, see IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer windows on page 153 steps. For more information about the Start Collaborations task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: Pausing collaborations 1. Select a collaboration from the Paused/Stopped Collaborations list. 2. Select Action Start from the menu bar to start the collaboration. Additional information: The window does not automatically update the collaboration lists based on their latest state. 3. Reiew the task output when the task completes to ensure that each collaboration started. 4. Repeat Steps 1 3 until you hae started all desired collaborations. 5. Select Action Refresh List from the menu bar to refresh the window. Objectie To pause a selected collaboration. Background information Collaborations are one of the processing resources managed by an InterChange Serer. Collaborations proide the business control logic between e-business applications. Required authorization role wics_admin Before you begin Open the Collaborations window as described in Opening the Collaborations window on page 297. When you finish If the collaboration did not pause immediately, wait about one minute and run the Check Status task for the collaboration to check the current status. Procedure You can perform this procedure from the Tioli desktop using a window. Initiate this task from the Collaborations window. For information about running a task from a window menu, see IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer windows on page 153 steps. For more information about the Pause Collaborations task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Select a collaboration from the Running Collaborations list. 2. Select Action Pause from the menu bar to pause the collaboration. Additional information: The window does not automatically update the collaboration lists based on their latest state. 300 IBM Tioli Monitoring for Business Integration: User s Guide

325 Stopping collaborations 3. Reiew the task output when the task completes to ensure that each collaboration paused. 4. Repeat Steps 1 3 until you hae paused all desired collaborations. 5. Select Action Refresh List from the menu bar to refresh the window. Objectie To stop a selected collaboration. Background information Collaborations are one of the processing resources managed by an InterChange Serer. Collaborations proide the business control logic between e-business applications. Stopping a collaboration and shutting down a collaboration are similar processes. Stopping a collaboration is a graceful process in which the collaboration completes pending work and then stops. Shutting down a collaboration is an immediate process in which the collaboration completes its current work item and stops. Required authorization role wics_admin Before you begin Open the Collaborations window as described in Opening the Collaborations window on page 297. When you finish If the collaboration did not stop immediately, wait about one minute and run the Check Status task for the collaboration to check the current status. Procedure You can perform this procedure from the Tioli desktop using a window. Initiate this task from the Collaborations window. For information about running a task from a window menu, see IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer windows on page 153 steps. For more information about the Stop Collaborations task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Select a collaboration from the Running Collaborations list. 2. Select Action Stop from the menu bar to stop the collaboration. Additional information: The window does not automatically update the collaboration lists based on their latest state. 3. Reiew the task output when the task completes to ensure that each collaboration stopped. 4. Repeat Steps 1 3 until you hae stopped all desired collaborations. 5. Select Action Refresh List from the menu bar to refresh the window. Chapter 24. Working with adapter controllers and collaborations 301

326 Shutting down collaborations Objectie To shut down a selected collaboration. Background information Collaborations are one of the processing resources that an InterChange Serer manages. Collaborations proide the business control logic between e-business applications. Stopping a collaboration and shutting down a collaboration are similar processes. Stopping a collaboration is a graceful process, in which the collaboration completes pending work and then stops. Shutting down a collaboration is an immediate process in which the collaboration completes its current work item and stops. Required authorization role wics_admin Before you begin Open the Collaborations window as described in Opening the Collaborations window on page 297. When you finish If the collaboration did not stop immediately, wait about one minute and run the Check Status task for the collaboration to check the current status. Procedure You can perform this procedure from the Tioli desktop using a window. Initiate this task from the Collaborations window. For information about running a task from a window menu, see IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer windows on page 153 steps. For more information about the Shut Down Collaborations task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Select a collaboration from the Running Collaborations list. 2. Select Action Shut Down from the menu bar to shut down the collaboration. Additional information: The window does not automatically update the collaboration lists based on their latest state. 3. Reiew the task output when the task completes to ensure that each collaboration stopped. 4. Repeat Steps 1 3 until you hae shut down all desired collaborations. 5. Select Action Refresh List from the menu bar to refresh the window. 302 IBM Tioli Monitoring for Business Integration: User s Guide

327 Chapter 25. Working with log and trace files for InterChange Serers This chapter describes how to work with log and trace files for InterChange Serers using IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. Table 48 proides a list of goals for working with log and trace files for InterChange Serers. The table also tells where to locate information about the procedures for each goal. Table 48. Working with log and trace files for InterChange Serers Goal Work with Interchange Serer log and trace files. Where to find procedures Opening a list of InterChange Serer log or trace files Work with Tioli log and trace files. Retrieing an InterChange Serer log file or trace file on page 304 Opening the Tioli Log File window on page 305 Retrieing Tioli log files on page 306 Deleting Tioli log files on page 307 Opening a list of InterChange Serer log or trace files Objectie To open the set of log or trace files that were created by an InterChange Serer. Background information The InterChange Serer records InterChange Serer internal processing in InterChange Serer log and trace files. The information in these files is useful for debugging InterChange Serer problems. These files are also useful for diagnosing InterChange Serer start up problems. An InterChange Serer is configured with log or trace file properties through a configuration file. An InterChange Serer can be configured to use one log or trace file or it can be configured to archie its log or trace files. If log or trace file archiing is used, the configuration file specifies how many archie log or trace files to maintain. Tioli proides the ability to iew the set of log or trace files created by an InterChange Serer. A window that contains the set of log or trace files opens in a window from which you can select files for retrieal and display. Required authorization role wics_user Copyright IBM Corp

328 Before you begin Not applicable When you finish Not applicable Procedure You can perform this task from the Tioli desktop using an icon context menu. Initiate this task from a WICSerer icon. For information about running a task from an icon, see Icon context menu on page 148 steps. For more information about the View InterChange Serer log or trace files task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click a WICSerer icon. 2. Do one of the following depending on the list of files you want to see: Click Diagnostics InterChange Serer Log Files to open the window showing the log files associated with the InterChange Serer. Click Diagnostics InterChange Serer Trace Files to open the window showing the trace files associated with the InterChange Serer. Retrieing an InterChange Serer log file or trace file Objectie To retriee a specific log or trace file created by an InterChange Serer. Background information The InterChange Serer records InterChange Serer internal processing in InterChange Serer log and trace files. The information in these files is useful for debugging InterChange Serer problems. These files are also useful for diagnosing InterChange Serer start up problems. An InterChange Serer is configured with log or trace file properties through a configuration file. An InterChange Serer can be configured to use one log or trace file or it can be configured to archie its log or trace files. If log or trace file archiing is used, the configuration file specifies how many archie log or trace files to maintain. Tioli proides the ability to iew the set of log or trace files created by an InterChange Serer. The set of log or trace files is displayed in a window from which you can select files for retrieal and display. The log files can be large. This task reports the last 500 lines of output of a file that contains more than 500 lines of information. If a file contains 500 or fewer lines of information the task reports the entire contents of the file. Required authorization role wics_user 304 IBM Tioli Monitoring for Business Integration: User s Guide

329 Before you begin Open the InterChange Serer Log Files or Trace Files window as described in Opening a list of InterChange Serer log or trace files on page 303. When you finish Not applicable Procedure You can perform this procedure from the Tioli desktop using an InterChange Serer Log Files or Trace Files window. Steps: 1. Click the file to retriee from the list of files in the Log Files window. 2. Click Log Files Get Log from the menu to retriee a log file or a trace file. 3. Reiew the task output to see the file contents when the task completes. Opening the Tioli Log File window Objectie To iew the set of log files that are associated with Tioli objects and access the operations you can perform on the log files. Background information Tioli log files are created under many different conditions. The interface proided here proides a way to work with a selected subset of the aailable log files. This subset consists of those log files that are associated with a specific Tioli object. For a full understanding of all log files, refer to the IBM Tioli Monitoring for Business Integration Problem Determination Guide. Tioli proides the ability to iew the set of log files associated with a specific object. The set of log files is displayed in a window from which you can select files for retrieal and deletion. The following log files are aailable through this interface: Endpoint log files This set of files consists of the log files created by tasks and resource models that run on a Tioli Endpoint. These log files generally take action on a resource on the endpoint, for example, starting a collaboration. Callback log files This set of files consists of those log files that support task inocation from an icon. These log files are created on the managed node on which the object resides. When performing diagnostic procedures, check the task log files first because they usually proide the more releant information. Required authorization role wics_user Before you begin Not applicable When you finish Not applicable Chapter 25. Working with log and trace files for InterChange Serers 305

330 Procedure You can perform this task from the Tioli desktop using an icon context menu. Initiate this task from one of the following icons: WICSerer WICSnmpAgent WICSAdapterAgent For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Open Tioli Log File Window task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: Retrieing Tioli log files 1. Right-click an icon: WICSerer, WICSnmpAgent, or WICSAdapterAgent. 2. Do one of the following to select the type of logs you want to see: Click Diagnostics Tioli Logs Endpoint to see a list of task log files. Click Diagnostics Tioli Logs Callback to see a list of callback log files. Additional information: When the task completes, a window opens showing the log files associated this Tioli object. Reiew the task output to see the log file contents. Additional information: The list of log files contains all log files associated with the specific object from which the request was made. The list might also contain log files that are not associated with any specific object. The log files can be distinguished by their file names. Refer to the IBM Tioli Monitoring for Business Integration Problem Determination Guide for an explanation of the Tioli log file naming conention. In addition to the list of log files, the window shows the host name and directory in which the log files reside. Objectie To retriee a specific Tioli log file. Background information Tioli log files are used to record Tioli internal processing. The information in these files is useful for debugging Tioli problems. The files are intended to be used in conjunction with IBM Software Support. Required authorization role wics_user Before you begin Open the Tioli Log Files window using the following procedure: Opening the Tioli Log File window on page 305. When you finish Not applicable 306 IBM Tioli Monitoring for Business Integration: User s Guide

331 Procedure You can perform this task from the Tioli desktop using a Tioli Log Files window. Steps: Deleting Tioli log files 1. Click the file to retriee from the Log Files list in the Tioli Log Files window. 2. Click Log Files Get Log from the menu to retriee the log file. 3. Reiew the task output to see the log file contents. Objectie To delete a specific Tioli log file. Background information Tioli log files are used to record Tioli internal processing. The information in these files is useful for debugging Tioli problems. The files are intended to be used in conjunction with IBM Software Support. Required authorization role wics_user Before you begin Open the Tioli Log Files window as described in Opening the Tioli Log File window on page 305. When you finish Not applicable Procedure You can perform this procedure from the Tioli desktop using a window. Steps: 1. Click the file to delete from the Log Files list in the Tioli Log Files window. 2. Click Log Files Delete Log from the menu bar to delete the log file. Additional information: The list of log files does not automatically refresh after you delete log files. 3. To iew the current set of log files, refresh the window by selecting Action Refresh List from the menu bar. Chapter 25. Working with log and trace files for InterChange Serers 307

332 308 IBM Tioli Monitoring for Business Integration: User s Guide

333 Chapter 26. Working with Tioli configuration settings for WebSphere InterChange Serers This chapter describes how to work with Tioli configuration settings for WebSphere InterChange Serers. Table 49 proides a list of goals for working with Tioli configuration settings for WebSphere InterChange Serers. The table also tells where to locate information about the procedures for each goal. Table 49. Working with Tioli configuration settings for WebSphere InterChange Serers Goal Reconfigure Tioli configuration. Where to find procedures Reestablishing Tioli Endpoints Setting data proider trace leels on page 310 Reestablishing Tioli Endpoints Objectie To change the Tioli Endpoint reference for a WebSphere InterChange Serer object. Background information Each IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer object runs tasks to a serer machine by using the serices of the Tioli Endpoint managing that machine. If the Tioli Endpoint is remoed and reinstalled, this reference is lost and tasks submitted to this object fail. By using this task, you can reset the Tioli Endpoint reference in the object to presere your existing object definitions and regain the ability to run tasks to the object. You can use this task to change a Tioli Endpoint reference to an existing machine only. You cannot change the reference to another machine. As part of the assignment process, the task checks the host name of last known endpoint with the new endpoint. The endpoint information is updated only if these host names are identical. Required authorization role wics_senior Before you begin Not applicable When you finish When the task completes, erify the new endpoint configuration by running the Check Status task to the changed object. Procedure You can perform this procedure from the Tioli desktop using an icon context menu. Initiate this task from one of the following icons: Copyright IBM Corp

334 WICSerer WICSnmpAgent WICSAdapterAgent For information about running a task from an icon context menu, see Icon context menu on page 148 steps. For more information about the Reestablish Tioli Endpoint task, see the IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide. Steps: 1. Right-click one of the following icons: WICSerer, WICSnmpAgent, or a WICSAdapterAgent. 2. Select Configuration Reestablish Endpoint. 3. Reiew the current definitions: Current Endpoint Name This field shows the name of the Tioli Endpoint currently associated with this object Current Host Name This field shows the host name of the machine currently associated with this object. When selecting the new endpoint, the new endpoint name can differ from the current endpoint name, but the host name of the new endpoint must match the alue of this field. A alue of NOT_FOUND means that the current host name could not be determined. 4. Select the new endpoint name from the list in the New Endpoint Name field. Additional information: The list contains the Tioli Endpoints that are defined in the local Tioli region. 5. Click Set and Execute to reestablish the Tioli Endpoint reference. Setting data proider trace leels Objectie To set the trace leel for the data proider for the resource models. Background information The data proiders are internal programs that proide information to resource models. The trace leel setting determines the leel of diagnostic information reported by the data proiders during their processing. Required authorization role wics_user Before you begin Not applicable When you finish When the task completes, reiew the task output to ensure that the trace leel was changed. Procedure You can perform this procedure from the Tioli desktop using an icon context menu or a task library. 310 IBM Tioli Monitoring for Business Integration: User s Guide

335 Icon context menu: Initiate this task from a WICSerer icon. For information about running a task from an icon context menu, see Icon context menu on page 148 steps. Steps: 1. Right-click the WICSerer icon. 2. Click Monitoring Set Trace Leel. 3. Perform Steps 5 in the following task library steps. Task library: Run the Set Data Proider Trace Leel task from the WICS Operational Tasks task library. For information about running a task from a task library, see Task library on page 145 steps. Steps: 1. Open the Monitoring for WebSphere ICS policy region. 2. Open the WICS Configuration Tasks task library. 3. Select and run the Set Data Proider Trace Leel task. 4. Select one or more WICSerer endpoints to which you want to run the task, and run the task. Additional information: The Set Data Proider Trace Leel window opens. Figure 44. Set Data Proider Trace Leel window 5. Click one of the following options to select the desired trace leel: ERROR Proides ERROR leel tracing. This is the default leel. DEBUG_MIN Proides additional debug information for IBM Customer Support. DEBUG_MID Proides additional debug information for IBM Customer Support. DEBUG_MAX Proides additional debug information for IBM Customer Support. 6. Click Set and Execute to run the task. Chapter 26. Working with Tioli configuration settings for WebSphere InterChange Serers 311

Installation and Setup Guide

Installation and Setup Guide IBM Tioli Monitoring for Business Integration Installation and Setup Guide Version 5.1.1 SC32-1402-00 IBM Tioli Monitoring for Business Integration Installation and Setup Guide Version 5.1.1 SC32-1402-00

More information

IBM Tivoli Monitoring for Messaging and Collaboration: Lotus Domino. User s Guide. Version SC

IBM Tivoli Monitoring for Messaging and Collaboration: Lotus Domino. User s Guide. Version SC IBM Tioli Monitoring for Messaging and Collaboration: Lotus Domino User s Guide Version 5.1.0 SC32-0841-00 IBM Tioli Monitoring for Messaging and Collaboration: Lotus Domino User s Guide Version 5.1.0

More information

License Administrator s Guide

License Administrator s Guide IBM Tioli License Manager License Administrator s Guide Version 1.1.1 GC23-4833-01 Note Before using this information and the product it supports, read the information under Notices on page 115. Second

More information

Tivoli IBM Tivoli Advanced Catalog Management for z/os

Tivoli IBM Tivoli Advanced Catalog Management for z/os Tioli IBM Tioli Adanced Catalog Management for z/os Version 2.2.0 Monitoring Agent User s Guide SC23-9818-00 Tioli IBM Tioli Adanced Catalog Management for z/os Version 2.2.0 Monitoring Agent User s Guide

More information

Problem Determination Guide

Problem Determination Guide IBM Tioli Monitoring for Business Integration Problem Determination Guide 5.1.1 SC32-1404-00 IBM Tioli Monitoring for Business Integration Problem Determination Guide 5.1.1 SC32-1404-00 Note Before using

More information

Installation and Setup Guide

Installation and Setup Guide IBM Tioli Monitoring for Messaging and Collaboration Installation and Setup Guide Version 5.1.1 GC32-0839-01 IBM Tioli Monitoring for Messaging and Collaboration Installation and Setup Guide Version 5.1.1

More information

Version 8.2 (Revised December 2004) Plus Module User s Guide SC

Version 8.2 (Revised December 2004) Plus Module User s Guide SC Tioli IBM Tioli Workload Scheduler Version 8.2 (Reised December 2004) Plus Module User s Guide SC32-1276-02 Tioli IBM Tioli Workload Scheduler Version 8.2 (Reised December 2004) Plus Module User s Guide

More information

WebSphere Message Broker Monitoring Agent User's Guide

WebSphere Message Broker Monitoring Agent User's Guide IBM Tioli OMEGAMON XE for Messaging on z/os Version 7.1 WebSphere Message Broker Monitoring Agent User's Guide SC23-7954-03 IBM Tioli OMEGAMON XE for Messaging on z/os Version 7.1 WebSphere Message Broker

More information

WebSphere MQ Configuration Agent User's Guide

WebSphere MQ Configuration Agent User's Guide IBM Tioli Composite Application Manager for Applications Version 7.1 WebSphere MQ Configuration Agent User's Guide SC14-7525-00 IBM Tioli Composite Application Manager for Applications Version 7.1 WebSphere

More information

IBM Tivoli Monitoring for Web Infrastructure: WebSphere Application Server. User s Guide. Version SC

IBM Tivoli Monitoring for Web Infrastructure: WebSphere Application Server. User s Guide. Version SC IBM Tivoli Monitoring for Web Infrastructure: WebSphere Application Server User s Guide Version 5.1.1 SC23-4705-01 IBM Tivoli Monitoring for Web Infrastructure: WebSphere Application Server User s Guide

More information

Internet Information Server User s Guide

Internet Information Server User s Guide IBM Tioli Monitoring for Web Infrastructure Internet Information Serer User s Guide Version 5.1.0 SH19-4573-00 IBM Tioli Monitoring for Web Infrastructure Internet Information Serer User s Guide Version

More information

IBM Tivoli Configuration Manager for Automated Teller Machines. Release Notes. Version 2.1 SC

IBM Tivoli Configuration Manager for Automated Teller Machines. Release Notes. Version 2.1 SC IBM Tioli Configuration Manager for Automated Teller Machines Release Notes Version 2.1 SC32-1254-00 IBM Tioli Configuration Manager for Automated Teller Machines Release Notes Version 2.1 SC32-1254-00

More information

Tivoli Business Systems Manager

Tivoli Business Systems Manager Tioli Business Systems Manager Version 3.1 Problem and Change Management Integration Guide SC32-9130-00 Tioli Business Systems Manager Version 3.1 Problem and Change Management Integration Guide SC32-9130-00

More information

iplanetwebserveruser sguide

iplanetwebserveruser sguide IBM Tioli Monitoring for Web Infrastructure iplanetwebsereruser sguide Version 5.1.0 SH19-4574-00 IBM Tioli Monitoring for Web Infrastructure iplanetwebsereruser sguide Version 5.1.0 SH19-4574-00 Note

More information

IBM Tivoli Enterprise Console. User s Guide. Version 3.9 SC

IBM Tivoli Enterprise Console. User s Guide. Version 3.9 SC IBM Tioli Enterprise Console User s Guide Version 3.9 SC32-1235-00 IBM Tioli Enterprise Console User s Guide Version 3.9 SC32-1235-00 Note Before using this information and the product it supports, read

More information

Tivoli IBM Tivoli Advanced Catalog Management for z/os

Tivoli IBM Tivoli Advanced Catalog Management for z/os Tioli IBM Tioli Adanced Catalog Management for z/os Version 2.2.0 Monitoring Agent Planning and Configuration Guide SC23-9820-00 Tioli IBM Tioli Adanced Catalog Management for z/os Version 2.2.0 Monitoring

More information

User s Guide GC

User s Guide GC Tioli IBM Tioli Monitoring for Databases: Sybase ASE 5.1.2 User s Guide GC32-9136-00 Tioli IBM Tioli Monitoring for Databases: Sybase ASE 5.1.2 User s Guide GC32-9136-00 Note Before using this information

More information

Tivoli Business Systems Manager

Tivoli Business Systems Manager Tioli Business Systems Manager Version 3.1 Introducing the Consoles SC32-9086-00 Tioli Business Systems Manager Version 3.1 Introducing the Consoles SC32-9086-00 Note Before using this information and

More information

Tivoli IBM Tivoli Advanced Audit for DFSMShsm

Tivoli IBM Tivoli Advanced Audit for DFSMShsm Tioli IBM Tioli Adanced Audit for DFSMShsm Version 2.2.0 Monitoring Agent Planning and Configuration Guide SC27-2348-00 Tioli IBM Tioli Adanced Audit for DFSMShsm Version 2.2.0 Monitoring Agent Planning

More information

Version Monitoring Agent User s Guide SC

Version Monitoring Agent User s Guide SC Tivoli IBM Tivoli Advanced Catalog Management for z/os Version 02.01.00 Monitoring Agent User s Guide SC23-7974-00 Tivoli IBM Tivoli Advanced Catalog Management for z/os Version 02.01.00 Monitoring Agent

More information

Tivoli IBM Tivoli Monitoring for Messaging and Collaboration: Microsoft Exchange Server

Tivoli IBM Tivoli Monitoring for Messaging and Collaboration: Microsoft Exchange Server Tioli IBM Tioli Monitoring for Messaging and Collaboration: Microsoft Exchange Serer Version 5.1.2 Problem Determination Guide SC32-9113-00 Tioli IBM Tioli Monitoring for Messaging and Collaboration:

More information

IBM Director Virtual Machine Manager 1.0 Installation and User s Guide

IBM Director Virtual Machine Manager 1.0 Installation and User s Guide IBM Director 4.20 Virtual Machine Manager 1.0 Installation and User s Guide Note Before using this information and the product it supports, read the general information in Appendix D, Notices, on page

More information

Road Map for the Typical Installation Option of IBM Tivoli Monitoring Products, Version 5.1.0

Road Map for the Typical Installation Option of IBM Tivoli Monitoring Products, Version 5.1.0 Road Map for the Typical Installation Option of IBM Tioli Monitoring Products, Version 5.1.0 Objectie Who should use the Typical installation method? To use the Typical installation option to deploy an

More information

Installing and Configuring Tivoli Enterprise Data Warehouse

Installing and Configuring Tivoli Enterprise Data Warehouse Installing and Configuring Tioli Enterprise Data Warehouse Version 1 Release 1 GC32-0744-00 Installing and Configuring Tioli Enterprise Data Warehouse Version 1 Release 1 GC32-0744-00 Installing and Configuring

More information

IBM Tivoli Federated Identity Manager Version Installation Guide GC

IBM Tivoli Federated Identity Manager Version Installation Guide GC IBM Tivoli Federated Identity Manager Version 6.2.2 Installation Guide GC27-2718-01 IBM Tivoli Federated Identity Manager Version 6.2.2 Installation Guide GC27-2718-01 Note Before using this information

More information

Web Security Developer Reference

Web Security Developer Reference IBM Tioli Access Manager for e-business Web Security Deeloper Reference Version 5.1 SC32-1358-00 IBM Tioli Access Manager for e-business Web Security Deeloper Reference Version 5.1 SC32-1358-00 Note Before

More information

Deployment Overview Guide

Deployment Overview Guide IBM Security Priileged Identity Manager Version 1.0 Deployment Oeriew Guide SC27-4382-00 IBM Security Priileged Identity Manager Version 1.0 Deployment Oeriew Guide SC27-4382-00 Note Before using this

More information

User s Guide for Software Distribution

User s Guide for Software Distribution IBM Tivoli Configuration Manager User s Guide for Software Distribution Version 4.2.1 SC23-4711-01 IBM Tivoli Configuration Manager User s Guide for Software Distribution Version 4.2.1 SC23-4711-01 Note

More information

Error Message Reference

Error Message Reference Security Policy Manager Version 7.1 Error Message Reference GC23-9477-01 Security Policy Manager Version 7.1 Error Message Reference GC23-9477-01 Note Before using this information and the product it

More information

Tivoli Monitoring Agent for IBM Tivoli Monitoring 5.x Endpoint

Tivoli Monitoring Agent for IBM Tivoli Monitoring 5.x Endpoint Tivoli Monitoring Agent for IBM Tivoli Monitoring 5.x Endpoint Version 6.1.0 User s Guide SC32-9490-00 Tivoli Monitoring Agent for IBM Tivoli Monitoring 5.x Endpoint Version 6.1.0 User s Guide SC32-9490-00

More information

Managing Server Installation and Customization Guide

Managing Server Installation and Customization Guide IBM Tioli Composite Application Manager for Application Diagnostics Version 7.1.0.4 Managing Serer Installation and Customization Guide SC27-2825-00 IBM Tioli Composite Application Manager for Application

More information

Tivoli Business Systems Manager

Tivoli Business Systems Manager Tioli Business Systems Manager Version 3.1 Installation and Configuration Guide SC32-9089-00 Tioli Business Systems Manager Version 3.1 Installation and Configuration Guide SC32-9089-00 Note Before using

More information

IBM Tivoli Monitoring for Databases: DB2. User s Guide. Version SC

IBM Tivoli Monitoring for Databases: DB2. User s Guide. Version SC IBM Tivoli Monitoring for Databases: DB2 User s Guide Version 5.1.0 SC23-4726-00 IBM Tivoli Monitoring for Databases: DB2 User s Guide Version 5.1.0 SC23-4726-00 Note Before using this information and

More information

Tivoli Tivoli Intelligent ThinkDynamic Orchestrator

Tivoli Tivoli Intelligent ThinkDynamic Orchestrator Tioli Tioli Intelligent ThinkDynamic Orchestrator Version 2.1 Installation Guide for Windows GC32-1604-00 Tioli Tioli Intelligent ThinkDynamic Orchestrator Version 2.1 Installation Guide for Windows GC32-1604-00

More information

Web Services Security Management Guide

Web Services Security Management Guide IBM Tioli Federated Identity Manager Version 6.2.2 Web Serices Security Management Guide GC32-0169-04 IBM Tioli Federated Identity Manager Version 6.2.2 Web Serices Security Management Guide GC32-0169-04

More information

IBM Agent Builder Version User's Guide IBM SC

IBM Agent Builder Version User's Guide IBM SC IBM Agent Builder Version 6.3.5 User's Guide IBM SC32-1921-17 IBM Agent Builder Version 6.3.5 User's Guide IBM SC32-1921-17 Note Before you use this information and the product it supports, read the information

More information

Tivoli Decision Support for OS/390. Administration Guide. Version 1.6, December 2003 SH

Tivoli Decision Support for OS/390. Administration Guide. Version 1.6, December 2003 SH Tioli Decision Support for OS/390 Administration Guide Version 1.6, December 2003 SH19-6816-08 Tioli Decision Support for OS/390 Administration Guide Version 1.6, December 2003 SH19-6816-08 Note Before

More information

Version Resource Model Reference Guide SH

Version Resource Model Reference Guide SH Tioli IBM Tioli Monitoring Version 5.1.2 Resource Model Reference Guide SH19-4570-03 Tioli IBM Tioli Monitoring Version 5.1.2 Resource Model Reference Guide SH19-4570-03 te Before using this information

More information

Installation and Configuration Guide

Installation and Configuration Guide IBM Tioli Directory Serer Installation and Configuration Guide Version 6.2 SC23-9939-00 IBM Tioli Directory Serer Installation and Configuration Guide Version 6.2 SC23-9939-00 Note Before using this information

More information

IBM Tivoli Service Level Advisor. Getting Started. Version 2.1 SC

IBM Tivoli Service Level Advisor. Getting Started. Version 2.1 SC IBM Tioli Serice Leel Adisor Getting Started Version 2.1 SC32-0834-03 IBM Tioli Serice Leel Adisor Getting Started Version 2.1 SC32-0834-03 Fourth Edition (September 2004) This edition applies to Version

More information

Tivoli Tivoli Intelligent ThinkDynamic Orchestrator

Tivoli Tivoli Intelligent ThinkDynamic Orchestrator Tioli Tioli Intelligent ThinkDynamic Orchestrator Version 2.1 Installation Guide for Unix GC32-1605-00 Tioli Tioli Intelligent ThinkDynamic Orchestrator Version 2.1 Installation Guide for Unix GC32-1605-00

More information

Tivoli Tivoli Provisioning Manager

Tivoli Tivoli Provisioning Manager Tioli Tioli Proisioning Manager Version 2.1 Installation Guide for Linux on Intel and Linux on iseries GC32-1616-00 Tioli Tioli Proisioning Manager Version 2.1 Installation Guide for Linux on Intel and

More information

Tivoli Identity Manager. End User Guide. Version SC

Tivoli Identity Manager. End User Guide. Version SC Tioli Identity Manager End User Guide Version 4.5.1 SC32-1152-02 Tioli Identity Manager End User Guide Version 4.5.1 SC32-1152-02 NOTE: Before using this information and the product it supports, read

More information

xseries Systems Management IBM Diagnostic Data Capture 1.0 Installation and User s Guide

xseries Systems Management IBM Diagnostic Data Capture 1.0 Installation and User s Guide xseries Systems Management IBM Diagnostic Data Capture 1.0 Installation and User s Guide Note Before using this information and the product it supports, read the general information in Appendix C, Notices,

More information

Tivoli Tivoli Provisioning Manager

Tivoli Tivoli Provisioning Manager Tioli Tioli Proisioning Manager Version 2.1 Installation Guide for Unix GC32-1615-00 Tioli Tioli Proisioning Manager Version 2.1 Installation Guide for Unix GC32-1615-00 Note: Before using this information

More information

IBM Tivoli Monitoring: AIX Premium Agent Version User's Guide SA

IBM Tivoli Monitoring: AIX Premium Agent Version User's Guide SA Tioli IBM Tioli Monitoring: AIX Premium Agent Version 6.2.2.1 User's Guide SA23-2237-06 Tioli IBM Tioli Monitoring: AIX Premium Agent Version 6.2.2.1 User's Guide SA23-2237-06 Note Before using this information

More information

IBM Security Role and Policy Modeler Version 1 Release 1. Glossary SC

IBM Security Role and Policy Modeler Version 1 Release 1. Glossary SC IBM Security Role and Policy Modeler Version 1 Release 1 Glossary SC27-2800-00 IBM Security Role and Policy Modeler Version 1 Release 1 Glossary SC27-2800-00 March 2012 This edition applies to ersion

More information

IBM. Installing, configuring, using, and troubleshooting. IBM Operations Analytics for z Systems. Version 3 Release 1

IBM. Installing, configuring, using, and troubleshooting. IBM Operations Analytics for z Systems. Version 3 Release 1 IBM Operations Analytics for z Systems IBM Installing, configuring, using, and troubleshooting Version 3 Release 1 IBM Operations Analytics for z Systems IBM Installing, configuring, using, and troubleshooting

More information

IBM i Version 7.2. Security Service Tools IBM

IBM i Version 7.2. Security Service Tools IBM IBM i Version 7.2 Security Serice Tools IBM IBM i Version 7.2 Security Serice Tools IBM Note Before using this information and the product it supports, read the information in Notices on page 37. This

More information

IBM Tivoli Storage Manager for Windows Version Tivoli Monitoring for Tivoli Storage Manager

IBM Tivoli Storage Manager for Windows Version Tivoli Monitoring for Tivoli Storage Manager IBM Tioli Storage Manager for Windows Version 7.1.0 Tioli Monitoring for Tioli Storage Manager IBM Tioli Storage Manager for Windows Version 7.1.0 Tioli Monitoring for Tioli Storage Manager Note: Before

More information

Installation and Configuration Guide

Installation and Configuration Guide IBM Tioli Directory Serer Installation and Configuration Guide Version 6.3 SC27-2747-00 IBM Tioli Directory Serer Installation and Configuration Guide Version 6.3 SC27-2747-00 Note Before using this information

More information

Tivoli System Automation Application Manager

Tivoli System Automation Application Manager Tioli System Automation Application Manager Version 3.1 Installation and Configuration Guide SC33-8420-01 Tioli System Automation Application Manager Version 3.1 Installation and Configuration Guide SC33-8420-01

More information

IBM Security Access Manager for Enterprise Single Sign-On Version 8.2. Administrator Guide SC

IBM Security Access Manager for Enterprise Single Sign-On Version 8.2. Administrator Guide SC IBM Security Access Manager for Enterprise Single Sign-On Version 8.2 Administrator Guide SC23-9951-03 IBM Security Access Manager for Enterprise Single Sign-On Version 8.2 Administrator Guide SC23-9951-03

More information

Monitor Developer s Guide

Monitor Developer s Guide IBM Tioli Priacy Manager for e-business Monitor Deeloper s Guide Version 1.1 SC23-4790-00 IBM Tioli Priacy Manager for e-business Monitor Deeloper s Guide Version 1.1 SC23-4790-00 Note: Before using this

More information

Troubleshooting Guide

Troubleshooting Guide Security Policy Manager Version 7.1 Troubleshooting Guide GC27-2711-00 Security Policy Manager Version 7.1 Troubleshooting Guide GC27-2711-00 Note Before using this information and the product it supports,

More information

Planning and Installation

Planning and Installation Tioli Workload Scheduler Version 8.5. (Reised October 200) Planning and Installation SC32-273-09 Tioli Workload Scheduler Version 8.5. (Reised October 200) Planning and Installation SC32-273-09 Note Before

More information

Data Protection for Microsoft SQL Server Installation and User's Guide

Data Protection for Microsoft SQL Server Installation and User's Guide IBM Tioli Storage Manager for Databases Version 6.4 Data Protection for Microsoft SQL Serer Installation and User's Guide GC27-4010-01 IBM Tioli Storage Manager for Databases Version 6.4 Data Protection

More information

IBM Security Access Manager for Web Version 7.0. Installation Guide GC

IBM Security Access Manager for Web Version 7.0. Installation Guide GC IBM Security Access Manager for Web Version 7.0 Installation Guide GC23-6502-02 IBM Security Access Manager for Web Version 7.0 Installation Guide GC23-6502-02 Note Before using this information and the

More information

IBM Tivoli Access Manager for WebSphere Application Server. User s Guide. Version 4.1 SC

IBM Tivoli Access Manager for WebSphere Application Server. User s Guide. Version 4.1 SC IBM Tioli Access Manager for WebSphere Application Serer User s Guide Version 4.1 SC32-1136-01 IBM Tioli Access Manager for WebSphere Application Serer User s Guide Version 4.1 SC32-1136-01 Note Before

More information

Tivoli Identity Manager

Tivoli Identity Manager Tioli Identity Manager Version 4.6 Serer Installation and Configuration Guide for WebSphere Enironments SC32-1750-01 Tioli Identity Manager Version 4.6 Serer Installation and Configuration Guide for WebSphere

More information

Upward Integration Modules Installation Guide

Upward Integration Modules Installation Guide IBM Director 4.1 Upward Integration Modules Installation Guide SC01-R051-20 IBM Director 4.1 Upward Integration Modules Installation Guide SC01-R051-20 Note: Before using this information and the product

More information

IBM. Basic system operations. System i. Version 6 Release 1

IBM. Basic system operations. System i. Version 6 Release 1 IBM System i Basic system operations Version 6 Release 1 IBM System i Basic system operations Version 6 Release 1 Note Before using this information and the product it supports, read the information in

More information

Administration Java Classes Developer Reference

Administration Java Classes Developer Reference IBM Tioli Access Manager for e-business Administration Jaa Classes Deeloper Reference Version 5.1 SC32-1356-00 IBM Tioli Access Manager for e-business Administration Jaa Classes Deeloper Reference Version

More information

IBM Tivoli Service Level Advisor. SLM Reports. Version 2.1 SC

IBM Tivoli Service Level Advisor. SLM Reports. Version 2.1 SC IBM Tioli Serice Leel Adisor SLM Reports Version 2.1 SC32-1248-00 IBM Tioli Serice Leel Adisor SLM Reports Version 2.1 SC32-1248-00 Fourth Edition (September 2004) This edition applies to Version 2.1

More information

Troubleshooting Guide

Troubleshooting Guide Tioli Access Manager for e-business Version 6.1.1 Troubleshooting Guide GC27-2717-00 Tioli Access Manager for e-business Version 6.1.1 Troubleshooting Guide GC27-2717-00 Note Before using this information

More information

IBM Tivoli Directory Server. System Requirements SC

IBM Tivoli Directory Server. System Requirements SC IBM Tioli Directory Serer System Requirements Version 6.2 SC23-9947-00 IBM Tioli Directory Serer System Requirements Version 6.2 SC23-9947-00 Note Before using this information and the product it supports,

More information

WebSEAL Installation Guide

WebSEAL Installation Guide IBM Tioli Access Manager WebSEAL Installation Guide Version 4.1 SC32-1133-01 IBM Tioli Access Manager WebSEAL Installation Guide Version 4.1 SC32-1133-01 Note Before using this information and the product

More information

IMS Performance Feature Guide and Reference

IMS Performance Feature Guide and Reference Tioli Decision Support for OS/390 IMS Performance Feature Guide and Reference Version 1.6, December 2003 SH19-6825-07 Tioli Decision Support for OS/390 IMS Performance Feature Guide and Reference Version

More information

IBM Tivoli Privacy Manager for e-business. Installation Guide. Version 1.1 SC

IBM Tivoli Privacy Manager for e-business. Installation Guide. Version 1.1 SC IBM Tioli Priacy Manager for e-business Installation Guide Version 1.1 SC23-4791-00 IBM Tioli Priacy Manager for e-business Installation Guide Version 1.1 SC23-4791-00 Note: Before using this information

More information

IBM Cognos Dynamic Query Analyzer Version Installation and Configuration Guide IBM

IBM Cognos Dynamic Query Analyzer Version Installation and Configuration Guide IBM IBM Cognos Dynamic Query Analyzer Version 11.0.0 Installation and Configuration Guide IBM Product Information This document applies to IBM Cognos Analytics ersion 11.0.0 and may also apply to subsequent

More information

IBM Tivoli Netcool Performance Manager Wireline Component October 2015 Document Revision R2E1. Pack Upgrade Guide IBM

IBM Tivoli Netcool Performance Manager Wireline Component October 2015 Document Revision R2E1. Pack Upgrade Guide IBM IBM Tioli Netcool Performance Manager Wireline Component October 2015 Document Reision R2E1 Pack Upgrade Guide IBM Note Before using this information and the product it supports, read the information in

More information

IBM Tivoli Composite Application Manager for WebSphere Application Server Version 7.1. Installation Guide

IBM Tivoli Composite Application Manager for WebSphere Application Server Version 7.1. Installation Guide IBM Tivoli Composite Application Manager for WebSphere Application Server Version 7.1 Installation Guide IBM Tivoli Composite Application Manager for WebSphere Application Server Version 7.1 Installation

More information

IBM Tivoli Service Level Advisor. Troubleshooting. Version 2.1 SC

IBM Tivoli Service Level Advisor. Troubleshooting. Version 2.1 SC IBM Tioli Serice Leel Adisor Troubleshooting Version 2.1 SC32-1249-00 First Edition (September 2004) This edition applies to Version 2.1 of IBM Tioli Serice Leel Adisor (program number 5724 C40) and to

More information

IBM Monitoring Agent for OpenStack Version User's Guide IBM SC

IBM Monitoring Agent for OpenStack Version User's Guide IBM SC IBM Monitoring Agent for OpenStack Version 7.5.0.1 User's Guide IBM SC27-6586-01 IBM Monitoring Agent for OpenStack Version 7.5.0.1 User's Guide IBM SC27-6586-01 Note Before using this information and

More information

IBM Security Access Manager for Web Version 7.0. Upgrade Guide SC

IBM Security Access Manager for Web Version 7.0. Upgrade Guide SC IBM Security Access Manager for Web Version 7.0 Upgrade Guide SC23-6503-02 IBM Security Access Manager for Web Version 7.0 Upgrade Guide SC23-6503-02 Note Before using this information and the product

More information

Tivoli Application Dependency Discovery Manager Version 7.3. Installation Guide IBM

Tivoli Application Dependency Discovery Manager Version 7.3. Installation Guide IBM Tioli Application Dependency Discoery Manager Version 7.3 Installation Guide IBM Tioli Application Dependency Discoery Manager Version 7.3 Installation Guide IBM Note Before using this information and

More information

Adapters in the Mainframe Connectivity Suite User Guide

Adapters in the Mainframe Connectivity Suite User Guide IBM WebSphere Business Integration Adapters Adapters in the Mainframe Connectiity Suite User Guide Adapter Version 2.2.x IBM WebSphere Business Integration Adapters Adapters in the Mainframe Connectiity

More information

Installation and Support Guide for Microsoft Windows NT and Windows 2000

Installation and Support Guide for Microsoft Windows NT and Windows 2000 IBM TotalStorage FAStT Storage Manager Version 8.3 Installation and Support Guide for Microsoft Windows NT and Windows 2000 Read Before Using The IBM Agreement for Licensed Internal Code is included in

More information

Tivoli Tivoli Intelligent ThinkDynamic Orchestrator

Tivoli Tivoli Intelligent ThinkDynamic Orchestrator Tioli Tioli Intelligent ThinkDynamic Orchestrator Version 2.1 Migration Guide for Windows GC32-1608-00 Tioli Tioli Intelligent ThinkDynamic Orchestrator Version 2.1 Migration Guide for Windows GC32-1608-00

More information

User Management Guide

User Management Guide IBM Tivoli Monitoring for Databases: Oracle User Management Guide Version 5.1.0 GC23-4731-00 IBM Tivoli Monitoring for Databases: Oracle User Management Guide Version 5.1.0 GC23-4731-00 Note Before using

More information

Tivoli Tivoli Provisioning Manager

Tivoli Tivoli Provisioning Manager Tioli Tioli Proisioning Manager Version 2.1 Migration Guide for Windows GC32-1618-00 Tioli Tioli Proisioning Manager Version 2.1 Migration Guide for Windows GC32-1618-00 Note: Before using this information

More information

Administrator s Guide

Administrator s Guide Tioli NetView for UNIX Administrator s Guide Version 7 1. 4 SC32-1246-00 Tioli NetView for UNIX Administrator s Guide Version 7 1. 4 SC32-1246-00 Note Before using this information and the product it

More information

Network Service Manager REST API Users Guide

Network Service Manager REST API Users Guide Netcool Configuration Manager Version 641 Network Serice Manager REST API Users Guide for R2E3 Netcool Configuration Manager Version 641 Network Serice Manager REST API Users Guide for R2E3 Note Before

More information

User s Guide for PeopleSoft Access Method

User s Guide for PeopleSoft Access Method IBM Tioli Workload Scheduler for Applications User s Guide for PeopleSoft Access Method Version 8.1.1 (Maintenance Release Noember 2003) SH19-8502-01 IBM Tioli Workload Scheduler for Applications User

More information

Problem Determination Guide (Revised March 30, 2007)

Problem Determination Guide (Revised March 30, 2007) IBM Tivoli Configuration Manager for Automated Teller Machines Problem Determination Guide (Revised March 30, 2007) Version 2.1 SC32-1411-01 IBM Tivoli Configuration Manager for Automated Teller Machines

More information

IBM. Client Configuration Guide. IBM Explorer for z/os. Version 3 Release 1 SC

IBM. Client Configuration Guide. IBM Explorer for z/os. Version 3 Release 1 SC IBM Explorer for z/os IBM Client Configuration Guide Version 3 Release 1 SC27-8435-01 IBM Explorer for z/os IBM Client Configuration Guide Version 3 Release 1 SC27-8435-01 Note Before using this information,

More information

Guide to Managing Common Metadata

Guide to Managing Common Metadata IBM InfoSphere Information Serer Version 11 Release 3 Guide to Managing Common Metadata SC19-4297-01 IBM InfoSphere Information Serer Version 11 Release 3 Guide to Managing Common Metadata SC19-4297-01

More information

Federated Identity Manager Business Gateway Version Configuration Guide GC

Federated Identity Manager Business Gateway Version Configuration Guide GC Tivoli Federated Identity Manager Business Gateway Version 6.2.1 Configuration Guide GC23-8614-00 Tivoli Federated Identity Manager Business Gateway Version 6.2.1 Configuration Guide GC23-8614-00 Note

More information

Tivoli IBM Tivoli Monitoring for Network Performance

Tivoli IBM Tivoli Monitoring for Network Performance Tivoli IBM Tivoli Monitoring for Network Performance Version 2 Release 1 Operator Guide SC31-6365-00 Tivoli IBM Tivoli Monitoring for Network Performance Version 2 Release 1 Operator Guide SC31-6365-00

More information

IBM Operational Decision Manager Version 8 Release 5. Installation Guide

IBM Operational Decision Manager Version 8 Release 5. Installation Guide IBM Operational Decision Manager Version 8 Release 5 Installation Guide Note Before using this information and the product it supports, read the information in Notices on page 51. This edition applies

More information

High Availability Guide for Distributed Systems

High Availability Guide for Distributed Systems IBM Tioli Monitoring Version 6.2.3 Fix Pack 1 High Aailability Guide for Distributed Systems SC23-9768-03 IBM Tioli Monitoring Version 6.2.3 Fix Pack 1 High Aailability Guide for Distributed Systems SC23-9768-03

More information

High Availability Guide for Distributed Systems

High Availability Guide for Distributed Systems IBM Tioli Monitoring Version 6.3.0 High Aailability Guide for Distributed Systems SC22-5455-00 IBM Tioli Monitoring Version 6.3.0 High Aailability Guide for Distributed Systems SC22-5455-00 Note Before

More information

Tivoli Tivoli Provisioning Manager

Tivoli Tivoli Provisioning Manager Tioli Tioli Proisioning Manager Version 2.1 Migration Guide for Unix GC32-1619-00 Tioli Tioli Proisioning Manager Version 2.1 Migration Guide for Unix GC32-1619-00 Note: Before using this information

More information

Tivoli Monitoring: Windows OS Agent

Tivoli Monitoring: Windows OS Agent Tioli Monitoring: Windows OS Agent Version 6.2.2 User s Guide SC32-9445-03 Tioli Monitoring: Windows OS Agent Version 6.2.2 User s Guide SC32-9445-03 Note Before using this information and the product

More information

Solutions for BSM Version 1.1. Solutions for BSM Guide

Solutions for BSM Version 1.1. Solutions for BSM Guide Solutions for BSM Version 1.1 Solutions for BSM Guide Solutions for BSM Version 1.1 Solutions for BSM Guide Note Before using this information and the product it supports, read the information in Notices.

More information

Tivoli IBM OMEGAMON z/os Management Console

Tivoli IBM OMEGAMON z/os Management Console Tivoli IBM OMEGAMON z/os Management Console Version 1.1.1 Planning, Installation, and Configuration Guide GC32-1902-00 Tivoli IBM OMEGAMON z/os Management Console Version 1.1.1 Planning, Installation,

More information

Programmer s Guide. Version 7 SC

Programmer s Guide. Version 7 SC NetView for UNIX Programmer s Guide Version 7 SC31-8897-00 Tioli NetView for UNIX Programmer s Guide Copyright Notice Copyright IBM Corporation 2001. All rights resered. May only be used pursuant to a

More information

Problem Determination Guide

Problem Determination Guide IBM Tioli Storage Productiity Center Problem Determination Guide Version 4.1 GC27-2342-00 IBM Tioli Storage Productiity Center Problem Determination Guide Version 4.1 GC27-2342-00 Note: Before using this

More information

Tivoli Storage Manager for Mail

Tivoli Storage Manager for Mail Tioli Storage Manager for Mail Version 6.1 Data Protection for Microsoft Exchange Serer Installation and User s Guide SC23-9796-00 Tioli Storage Manager for Mail Version 6.1 Data Protection for Microsoft

More information

IBM. RSE for z/os User's Guide. IBM Explorer for z/os. Version 3 Release 1 SC

IBM. RSE for z/os User's Guide. IBM Explorer for z/os. Version 3 Release 1 SC IBM Explorer for z/os IBM RSE for z/os User's Guide Version 3 Release 1 SC27-8433-03 IBM Explorer for z/os IBM RSE for z/os User's Guide Version 3 Release 1 SC27-8433-03 Note Before using this information,

More information