TeamQuest SMFII and TeamQuest Online for Unisys MCP Systems

Transcription

2 The names, places and/or events used in this publication are purely fictitious and are not intended to correspond to any real individual, group, company or event. Any similarity or likeness to any real individual, company or event is purely coincidental and unintentional. NO WARRANTIES OF ANY NATURE ARE EXTENDED BY THE DOCUMENT. Any product and related material disclosed herein are only furnished pursuant and subject to the terms and conditions of a license agreement. The only warranties made, remedies given, and liability accepted by TeamQuest, if any, with respect to the products described in this document are set forth in such license agreement. TeamQuest cannot accept any financial or other responsibility that may be the result of your use of the information in this document or software material, including direct, indirect, special, or consequential damages. You should be very careful to ensure that the use of this information and/or software material complies with the laws, rules, and regulations of the jurisdictions with respect to which it is used. The information contained herein is subject to change without notice. Revisions may be issued to advise of such changes and/or additions. U.S. Government Rights. All documents, product and related material provided to the U.S. Government are provided and delivered subject to the commercial license rights and restrictions described in the governing license agreement. All rights not expressly granted therein are reserved. TeamQuest, the TeamQuest logo, TeamQuest Alert, TeamQuest Analyzer, TeamQuest Baseline, TeamQuest CMIS, TeamQuest Harvest, TeamQuest IT Service Analyzer, TeamQuest IT Service Reporter, TeamQuest Manager, TeamQuest Model, TeamQuest On the Web, TeamQuest Predictor, TeamQuest Online, TeamQuest Surveyor, TeamQuest View, and Performance Surveyor are trademarks or registered trademarks of TeamQuest Corporation in the US and/or other countries. Unisys and ClearPath are registered trademarks of Unisys Corporation in the US and/or other countries. All other trademarks and service marks are the property of their respective owners.

3 About This Guide Purpose Scope Audience TeamQuest SMFII and TeamQuest Online are Unisys Master Control Program (MCP) software packages that address the capacity management, performance analysis, and performance monitoring needs of your system. TeamQuest SMFII and TeamQuest Online are installed on a Unisys MCP host system and use the TeamQuest View software installed on a workstation for data display and analysis. The TeamQuest SMFII and TeamQuest Online Administration Guide for Unisys MCP Systems describes TeamQuest SMFII and TeamQuest Online. It tells you how to use the TeamQuest SMFII software as a tool for performing capacity management and performance analysis tasks on your system and how to use the TeamQuest Online software as a performance monitoring tool. This guide describes the TeamQuest SMFII and TeamQuest Online software. It tells how to use the TeamQuest SMFII and TeamQuest Online probes to collect and store performance data in the history database and the monitor file. It provides conceptual information on the TeamQuest Performance Management Architecture and the database structure. This guide is intended for those who are interested in performance analysis and capacity management of Unisys MCP systems. TeamQuest Online addresses the needs of the performance analyst. TeamQuest SMFII addresses the needs of the performance analyst and the capacity planner. The performance analyst can use TeamQuest SMFII or TeamQuest Online to view performance data that has been collected at a high granularity. The capacity planner can use TeamQuest SMFII to view data across long periods of time. Marketing representatives and technical managers who are interested in the capacity management of Unisys MCP systems can also use TeamQuest SMFII. TQ iii

4 About This Guide How to Use This Guide This guide contains information specific to the host component of the TeamQuest SMFII and TeamQuest Online software. This guide is intended to be used with the TeamQuest View User Guide, the TeamQuest SMFII and TeamQuest Online Utilities Reference Manual for Unisys MCP Systems and the TeamQuest SMFII and TeamQuest Online Data Collectors Reference Manual for Unisys MCP Systems. These manuals provide information about the data collection and database management programs for use with TeamQuest SMFII and TeamQuest Online. Organization This guide contains the following: Section 1. Introduction This section provides an introduction to TeamQuest SMFII and TeamQuest Online. It describes the products, provides an overview of TeamQuest SMFII and TeamQuest Online processing, and tells how the products work. It also lists the hardware and software requirements for using TeamQuest SMFII and TeamQuest Online. Section 2. TeamQuest SMFII and TeamQuest Online Concepts This section explains the history database structure and the monitor file structure. It also describes workload management and alarm definition. Section 3. Probe Manager This section describes the Probe Manager program and the data it collects about system resource usage. It includes information on resource requirements and data file organization. It describes the Probe Manager commands and provides a description of each command, as well as the command syntax and examples. This section also includes information on the Library and Portfile Communications interfaces for use with TeamQuest SMFII. Section 4. TeamQuest SMFII Administration Interface This section provides information on how to use the TeamQuest SMFII Administration Interface. It also provides information on configuring alarms and defining workloads. Appendix A. Understanding Railroad Diagrams This appendix explains how to read and interpret the diagrams used to represent the syntax of commands. iv TQ

5 About This Guide Results After reading and using this guide, you will be able to use TeamQuest SMFII or TeamQuest Online on the host system, maintain the history database or monitor file, and use the data collection probes to gather measurement data in the database. Related Product Information The following related documents may be helpful to you when using TeamQuest SMFII or TeamQuest Online. Use the version that corresponds to the level of software in use at your site. TeamQuest Product Documentation If you are using TeamQuest manuals, you can find related product information in the following documents: TeamQuest Express User Guide for Unisys MCP Systems (TQ 02262) This guide provides information about the TeamQuest Express software as a tool for performing capacity management and performance analysis tasks on your Unisys MCP system. TeamQuest Products Installation Guide for Unisys MCP Systems (TQ 02212) This guide provides information about installing the TeamQuest SMFII, TeamQuest Online, TeamQuest Probes, TeamQuest View, TeamQuest Model, TeamQuest Express, and TeamQuest PMPlus software on your Unisys MCP system. TeamQuest SMFII and TeamQuest Online Utilities Reference Manual for Unisys MCP Systems (TQ 02261) This manual provides information about Query, the LOGCONSOLIDATOR program, File Maintenance Utility (FMU), and the Datamapper utility for use with the TeamQuest SMFII or TeamQuest Online software. TeamQuest SMFII and TeamQuest Online Data Collectors Reference Manual for Unisys MCP Systems (TQ 02228) This manual describes the data collection probes available for use with the TeamQuest SMFII, TeamQuest Online, and TeamQuest Probes products. TeamQuest View User Guide (TQ 01401) This guide describes how to use the TeamQuest View software. TeamQuest View is the user interface to TeamQuest SMFII and TeamQuest Online. You use TeamQuest View to view history and real-time monitor reports from data collected by TeamQuest SMFII or TeamQuest Online. TQ v

6 About This Guide Unisys Product Documentation If you are using Unisys manuals, you can find related product information in the following documents: GETSTATUS/SETSTATUS Programming Reference Manual ( ) This manual explains the function of GETSTATUS and SETSTATUS and provides both input information needed to write the call and output information that can help interpret the results that are returned. I/O Subsystem Programming Guide ( ) This guide contains information about how to program for various types of peripheral files and how to program for interprocess communication using port files. System Commands Operations Reference Manual ( ) This manual contains a complete description of the system commands you use to control system resources and work flow. Task Attributes Programming Reference Manual ( ) This manual documents the SYSTEMSTATUS function of the DCALGOL programming language. Work Flow Language (WFL) Programming Reference Manual ( ) This manual presents the complete syntax and semantics of WFL. You can use this language to construct jobs that compile or run programs written in other languages and that perform library maintenance such as copying files. vi TQ

7 About This Guide How to Access Portable Document Format (PDF) Files All TeamQuest product documentation is available as PDF files. PDF files can either be downloaded from the TeamQuest Web site or they can be viewed from your product DVD. You must have the Adobe Reader software from installed on your workstation to view the PDF files. To download product documentation from the Web site: 1. Access the TeamQuest Web site at 2. Click the Support tab, then Customer Area. 3. Log in to the Customer Area. 4. Click the Downloads link. 5. Click the Product Documentation link for the desired release level and product platform. 6. Select the document you wish to download. When the download is complete, the PDF file will open. 7. Select the Save As command from the File menu to save a copy of this document. To access product documentation from your product DVD: 1. Load the DVD in your disk drive. The disk contents dialog box is displayed. 2. Open the welcome.pdf file. The welcome.pdf file can be used to navigate to the desired PDF file. You may wish to copy the welcome.pdf file and the pdfdocs folder to your server so multiple users have convenient access to the product documentation. Note: When copying the welcome file and the pdfdocs folder, you must maintain the established directory structure. If the directory structure is not maintained, the navigation links within the welcome.pdf file will not open the documents located in the pdfdocs folder. TQ vii

8 About This Guide Notation Conventions The examples in this guide show, as nearly as possible, how your input, system output, and screens appear on a video display terminal. All command syntax appears as railroad diagrams. For more information on how to use these diagrams, see Appendix A. When using TeamQuest SMFII or TeamQuest Online on the host system, the following conventions apply: You can enter commands or other required input in either uppercase or lowercase letters. Both ways are shown in the examples in this manual. Brackets are used to indicate optional entries. For example: COPY = [AS <usercode>= ] FROM <tape name> TO <packname>(pack) This shows that the AS <usercode>= is optional. A pair of less than and greater than signs (< >) are used to indicate values that you supply. For example: COPY = [AS <usercode>= ] FROM <tape name> TO <packname>(pack) This example indicates that you must supply an optional usercode, a tape name, and a packname. For TeamQuest PC software menu selections, a command sequence is shown as Start > Programs > TeamQuest > TeamQuest View This sequence indicates that to perform the necessary function, you select Programs from the Start menu, and then select TeamQuest from the Programs submenu, and TeamQuest View from the TeamQuest submenu. viii TQ

9 Contents About This Guide Section 1. Introduction 1.1. What Is TeamQuest Software for Unisys MCP Systems? What Can You Do With TeamQuest Software for Unisys MCP Systems? What Is TeamQuest SMFII? What Is TeamQuest Online? What Can You Do with TeamQuest SMFII and TeamQuest Online? Processing Overview How Do TeamQuest SMFII and TeamQuest Online Work? The Host Software Component TeamQuest SMFII Administration Interface TeamQuest View Software Section 2. TeamQuest SMFII and TeamQuest Online Concepts 2.1. History Database Structure Monitor File Structure Data References with TeamQuest View Workload Management Using Workload Probes Specifying Workload Definitions Example Workload Set Definition Workload Definition Language Post-Collection Workload Characterization Alarms Management TQ ix

10 Contents Section 3. Probe Manager 3.1. Data File Organization Probe Manager Commands ALARMS AUTOQUIT AUTOTF CLOSE CONFIGURE DATABASE HISTORY IOTRACE LIBRARY MONITOR MONITORDATABASE PORT PRIORITY QUIT SAMPLE or COLLECT STATUS TIMING TRANSFER or TF VERSION Probe Manager Interfaces LIBRARY Interface Data Types Probe Manager Program Control Flow Define_Dbitem Define_Key_Dbitem Define_Key_Value Define_Characteristics Define_Weight_Factor Smfii_Write Get_Config_Info Get_Workload_Info Initialize_Probe Enable_Probe Disable_Probe Terminate_Probe Sample_Probe Configure_Probe Installing the Probe PORTFILE Communications Interface PORTFILE Characteristics Specifying Data Items Validating PORT Declarations PORT Application Example x TQ

11 Contents Section 4. TeamQuest SMFII Administration Interface 4.1. Performing Administrative Tasks Logging In Selecting a Database Using the Interface Using the Task Entry Pages Using the Edit Pages Using the Alarm Policy TeamQuest SMFII Probe Manager Default Alarm Definitions Configuring Alarms Viewing the Alarm List Adding an Alarm Definition Editing an Alarm Definition Deleting an Alarm Definition Changing the Status of an Alarm Activating Changes Configuring Aliases Viewing the Alias List Adding an Alias Definition Editing an Alias Definition Deleting an Alias Definition Configuring Actions Viewing the Actions List Adding an Action Definition Editing an Action Definition Deleting an Action Definition Using the Workload Policy Viewing the Workload Set List Adding a Workload Set Adding a Workload to a Workload Set Specifying the Order of Workloads Changing the Status of a Workload Set Editing a Workload Set Editing a Workload Definition Deleting a Workload Set Deleting a Workload Analyzing a Workload Set Activating Changes TQ xi

12 Contents 4.5. Using the Probe Manager Policy Initiating Probe Manager Terminating the Probe Manager Executing Probe Manager Commands ALARMS Command AUTOQUIT Command AUTOTF Command CLOSE Command CONFIGURE Command DATABASE Command HISTORY Command IOTRACE Command LIBRARY Command MONITOR Command MONITORDATABASE Command PORT Command PRIORITY Command SAMPLE Command STATUS Command TIMING Command TRANSFER Command VERSION Command Editing Parameter Files Maintaining System Licenses Viewing License Information Editing the License File Appendix A. Understanding Railroad Diagrams A.1. What Are Railroad Diagrams?... A 1 A.1.1. Constants and Variables... A 2 A.1.2. Constraints... A 3 A.2. Following the Paths of a Railroad Diagram... A 7 A.3. Railroad Diagram Examples with Sample Input... A 8 Glossary... 1 Bibliography... 1 Index... 1 xii TQ

13 Figures 1 1. TeamQuest SMFII and TeamQuest Online Components Workload Characterization Post-Collection Workload Characterization Probe Manager and Probe Library Routines Initializing the Probe Starting the Probe Sampling Performance Data Stopping the Probe Terminating the Probe Configuring the Probe TQ xiii

14

15 Tables 2 1. History Database Modules and Corresponding Data Files Probe Relationships Default Alarm Descriptions A 1. Railroad Constraints... A 6 TQ xv

16

17 Section 1 Introduction This section provides an introduction to the TeamQuest software for Unisys Master Control Program (MCP) systems. Read the following topics to learn more about these products and how you can use them for performance analysis and capacity planning tasks. What Is TeamQuest Software for Unisys MCP Systems? (see 1.1) What Can You Do With TeamQuest Software for Unisys MCP Systems? (see 1.2) What Is TeamQuest SMFII? (see 1.3) What Is TeamQuest Online? (see 1.4) What Can You Do with TeamQuest SMFII and TeamQuest Online? (see 1.5) Processing Overview (see 1.6) How Do TeamQuest SMFII and TeamQuest Online Work? (see 1.7) TQ

18 Introduction 1.1. What Is TeamQuest Software for Unisys MCP Systems? TeamQuest software for Unisys MCP systems is a family of products which addresses the needs of capacity management and performance analysis of your computer systems. This integrated family of products allows you to choose the tools that you need to manage the performance at your site. The TeamQuest software for Unisys MCP systems consists of the following products: TeamQuest SMFII TeamQuest SMFII is a performance tool for Unisys MCP systems. It collects a comprehensive set of statistics for real-time monitoring of system activity, historical performance reporting, performance problem diagnosis and resolution, and trend analysis. This product consists of two parts: the TeamQuest SMFII Administration Interface and TeamQuest View. The TeamQuest SMFII Administration Interface provides a user interface for alarms, workloads, and inquiring and controlling the run-time behavior of the Probe Manager. TeamQuest View provides a graphical user interface for detailed data reporting and analysis. TeamQuest Online TeamQuest Online is a performance management tool for Unisys MCP systems specifically focused on real-time monitoring of system activity. This product consists of TeamQuest View and a subset of the services provided by TeamQuest SMFII. TeamQuest Probes TeamQuest Probes is a set of data collectors that supplements the data provided in TeamQuest SMFII or TeamQuest Online. These additional data collectors measure performance information from Data Management Systems II (DMSII) databases, Communications Management Systems (COMS) transaction programs, Logic and Information Network Compiler (LINC) applications, BNAV2 network components, and Terminal Control Protocol (TCPIP) collects TCP/IP connection statistics for various network entities. TeamQuest Extended Network Application Platform (NAP) Probes TeamQuest Extended NAP Probes is a set of data collectors that supplement the NAP data collectors provided in TeamQuest SMFII. These additional data collectors provide status information on various components within the NAP system. TeamQuest Express TeamQuest Express is a performance tool ideally suited for small to medium-sized sites. It helps sites with limited technical resources track historical trends of system-wide performance statistics, analyze program resource usage, and measure file and tape activity. 1 2 TQ

19 Introduction TeamQuest Model TeamQuest Model provides capacity planning and what-if analysis. TeamQuest Model obtains its data from TeamQuest products running on Unisys MCP systems, OS 2200 systems, UNIX systems, or Microsoft Windows systems. It provides an easy-to-use interface into a set of powerful modeling algorithms. An interface to Hewlett-Packard OpenView Performance is also available. TeamQuest PMPlus TeamQuest PMPlus bundles performance management software for Unisys MCP systems, Microsoft Windows systems, or UNIX systems, giving you total control of your Unisys MCP configuration. This cross-platform solution combines TeamQuest SMFII, TeamQuest Probes, and TeamQuest View for UNIX and Microsoft Windows systems. Together these products provide a comprehensive solution unique to your Unisys MCP environment What Can You Do With TeamQuest Software for Unisys MCP Systems? The TeamQuest software for Unisys MCP systems allows you to address a wide range of performance and capacity problems in your enterprise: Use alarms to detect complex situations and provide event-based performance management. Monitor one or more systems in detail with graphical and textual reports. Typical users include operators, system administrators, and performance analysts. Analyze historical data with powerful time selection and reporting, including trend analysis. Typical users are performance analysts and capacity planners. Characterize workloads along business lines to understand and monitor resource usage and requirements. Typical users are performance analysts and capacity planners. Model your systems for hardware sizing, capacity planning, and what-if tuning scenarios. Typical users include performance analysts and capacity planners. TQ

20 Introduction 1.3. What Is TeamQuest SMFII? TeamQuest SMFII for Unisys MCP software provides the services for the TeamQuest software on your Unisys MCP system. TeamQuest SMFII must be installed on every monitored host and consists of the components that collect, store, manage, and administer the performance data. TeamQuest SMFII performs the following functions for the TeamQuest software: Data collection and storage Data is collected by probes and stored in the history database and a monitor file. You can select from a predefined set of data collection probes. Administration You can control the data that is collected, how often it is collected, and how it is stored. You can also characterize workloads and manage your license keys. Alarms You can specify conditions and actions for TeamQuest SMFII to test and act upon. Application interfaces TeamQuest SMFII makes the collected and stored data available to the performance applications, such as TeamQuest View and TeamQuest Model, using secure application interfaces What Is TeamQuest Online? TeamQuest Online is a performance monitoring tool for Unisys MCP systems. TeamQuest Online gathers measurement data into a monitor file and makes it available for real-time monitor reports. TeamQuest Online operates like TeamQuest SMFII; however, it contains only a subset of the functionality of TeamQuest SMFII. 1 4 TQ

21 Introduction 1.5. What Can You Do with TeamQuest SMFII and TeamQuest Online? TeamQuest SMFII is the required product within the TeamQuest software. TeamQuest Online is a subset of TeamQuest SMFII. These products allow you to perform the following tasks: Analyze and view system performance data using a real-time monitor Present reports simultaneously from multiple hosts View predefined reports from a real-time monitor Perform correlation analysis between performance statistics Produce hard-copy output of reports, using a printer Cut and paste reports to software packages such as spreadsheets or word processors Export report data into ASCII files, which can be used in other software packages such as spreadsheets or word processors TeamQuest SMFII provides the additional capabilities to perform the following tasks: Build and maintain a performance history database, containing performance analysis data Generate and present reports in textual or graphic format, showing historical data from the performance database Define reports to reflect site-specific configurations Track hardware configurations Build and report workload characterizations Perform threshold checking on performance data and generate alarms when values exceed predefined thresholds TQ

22 Introduction 1.6. Processing Overview TeamQuest SMFII and TeamQuest Online processing consists of two phases: data collection and data display. These phases include the various activities involved in creating the history database or the monitor file, maintaining the history database or monitor file, and using the data stored in the history database or monitor file for report generation and graphics displays. TeamQuest SMFII and TeamQuest Online control the activities for data collection and data display processing. Data Collection TeamQuest SMFII and TeamQuest Online use software probes to gather data from the MCP by using standard system software interfaces. Data collection depends on the probe parameters set in the parameters file. Data Display During the data display phase, TeamQuest View retrieves data from the history database or the monitor file. You can then use this data to generate reports and display them in textual or graphic format. See the TeamQuest View User Guide for more information. Reports can also be generated on the host system using SYSTEM/TQ/SMFII/QUERY or SYSTEM/TQ/ONLINE/QUERY. See the TeamQuest SMFII and TeamQuest Online Utilities Reference Manual for Unisys MCP Systems for additional information. 1 6 TQ

23 Introduction Figure 1 1 shows the components of TeamQuest SMFII and TeamQuest Online. MCP Datamapper Probes FMU Probe Manager LOG- CONSOLIDATOR Monitor File History Database Query TQDATA TeamQuest View Administration Interface Reports Exported Report Data Files Figure 1 1. TeamQuest SMFII and TeamQuest Online Components TQ

24 Introduction 1.7. How Do TeamQuest SMFII and TeamQuest Online Work? TeamQuest SMFII and TeamQuest Online consist of a host software package and the TeamQuest View user interface software. The host software collects performance data, stores this data in the history database or monitor file, and maintains the history database or the monitor file. TeamQuest View requests performance data from the history database or the monitor file and creates reports The Host Software Component The TeamQuest SMFII and TeamQuest Online host software runs on your Unisys MCP system, collecting data and maintaining the history database or the monitor file. TeamQuest SMFII and TeamQuest Online use probes to collect data, with each probe collecting data from a different source. Once the data is collected, TeamQuest SMFII and TeamQuest Online store the data for future retrieval. TeamQuest SMFII also stores hardware configurations in the database so that as you are looking at past performance data, you can also view the hardware configuration that produced the performance data. You can monitor the performance data of your system in real time by using TeamQuest SMFII or TeamQuest Online. TeamQuest SMFII and TeamQuest Online collect monitor data at a short time interval and make this data available to TeamQuest View for reporting. TeamQuest SMFII or TeamQuest Online updates the monitor reports on a regular timed basis so you can see what is currently happening on your system. 1 8 TQ

25 Introduction The TeamQuest SMFII and TeamQuest Online host components consists of the following parts: Data collection TeamQuest SMFII and TeamQuest Online have three programs that perform data collection: Probe Manager The Probe Manager controls collection of real-time performance information on system resource usage by a number of probes. Each probe collects data at various intervals. The Probe Manager schedules these probes. For information on the Probe Manager program, see Section 3. Probes The probes collect performance data about the computer system. This data is stored in the history database and the monitor file for future retrieval and reporting. Four probes are available with TeamQuest Online: Globals, I/O, Family I/O, and Task Monitor. The following probes are available with TeamQuest SMFII: Globals, I/O, Family I/O, Task Monitor, Mixtrace, Mix Workload, Mix Workload I/O, I/O Trace, Environment, Configuration, License, and NAP. For detailed information on these probes, see the TeamQuest SMFII and TeamQuest Online Data Collectors Reference Manual for Unisys MCP Systems. LOGCONSOLIDATOR The LOGCONSOLIDATOR program is designed to process the SUMLOG files and create TeamQuest SMFII database files. The information extracted from the log files is condensed and placed in data files by type, such as task history, file activity, mainframe errors, or I/O errors. For information on the LOGCONSOLIDATOR program, see the TeamQuest SMFII and TeamQuest Online Utilities Reference Manual for Unisys MCP Systems. Monitor file The TeamQuest SMFII and TeamQuest Online monitor file is a circular file that allows monitor data to be stored and retrieved quickly. When the maximum amount of data has been stored in the file, the oldest set of collected data items for a given time is dropped and replaced with the new set of data items. TeamQuest View can generate monitor reports from data in the monitor file. TQ