Document Outline

• What’s New in This Manual
• About This Manual
• 1 Introduction to Measure
  • Continuous Operation and Measurement
  • Measurable Resources
  • Displays of Measurement Data
  • Customized Performance Tools
  • Measure Support for Open System Services (OSS)
  • Measure Support for ANSI SQL Names
  • Measure Support for Dynamic-Link Libraries (DLLs)
  • Measure Processes and Files
    • MEASCHMA
    • MEASCOM
    • MEASCTL
    • MEASDDLS
    • MEASDDLF
    • MEASDDLB
    • MEASDDLZ
    • MEASDECS
    • MEASFH
    • MEASIMMU
    • MEASMON
    • OMEASG
    • OMEASP
    • RMEASP
  • Relationship Between the Measure Components
• 2 Measure Command Interface (MEASCOM)
  • CommandLanguage Format
    • Entering Commands
    • Using Abbreviations in Commands
  • Starting and Stopping the Measure Subsystem
  • Starting and Stopping MEASCOM
  • Redirecting Command Output
  • Creating a Custom Startup File
  • Accessing Online Help
  • Modifying D-Series Command Files for Systems Running G-Series RVUs
  • Accessing D-Series Measurement Files From a System Running a GSeries RVU
• 3 Configuring and Running Measurements
  • The Measurement Configuration
    • Entity Types and Specifications
    • Creating the Configuration
  • Running a Measurement
    • Predefined Counters
    • Starting a Measurement
    • Stopping a Measurement
  • Checking Measurement Activity and Data Files
    • Checking Subsystem Status
    • Checking Data File Size and Content
    • Checking Data File Accessibility
  • Potential Data File Errors
  • Viewing Reports of Measurement Data
    • Viewing Reports From Data Files
    • Viewing Reports From Active Counters
• 4 Formatting Reports and Plots
  • Controlling Content and Format of Reports
    • REPORT Attributes
    • Controlling the Report Window
    • Displaying Interpreted and Uninterpreted Values
  • Plotting Measurement Data
    • The Plot Definition
    • PLOT Attributes
    • Generating Plots
    • Changing the Scale
    • Changing the Orientation
    • Changing the Density
    • Changing the Plot Window
  • Plotting Execution Modes
  • Producing Structured Files of Measurement Data
    • Step 1: Produce Structured Report Files
    • Step 2: Load the Structured Files
    • Step 3: Build the Data Dictionary
    • Generating Reports Using Enform and SQL/MP Products
    • Loading Data From Different Systems to Common Files
• 5 Defining Custom Counters
  • Task 1: Instrument an Application
    • Step 1: Source in the MEASDECS File
    • Step 2: Declare Integer Variable, Array, and Offset
    • Step 3: Initialize the Counter (Call MEASCOUNTERBUMPINIT)
    • Step 4: Bump the Counter (Call MEASCOUNTERBUMP)
    • Sample TAL Program
  • Task 2: Measure the Application
    • Step 1: Specify the Processes Running the Application
    • Step 2: Specify the User-Defined Counters in the Application to Measure
    • Considerations
  • Sample COBOL Application
• 6 Creating a Custom Measurement Application
  • Preparing Your Program and Defining the Configuration
    • Reading Declaration Files
    • Allocating Space for the Measure Control Block
    • Defining Entities
    • Preparing the Configuration Table
  • Starting and Stopping the Measure Subsystem
  • Starting and Stopping a Measurement
    • Step 1: Call MEASOPEN
    • Step 2: Call MEASCONFIGURE
    • Step 3: Call MEASCONTROL
    • Step 4: Call MEASCLOSE (Optional)
  • Reading Counter Records
    • Reading Counter Records From a Data File
    • Reading Active Counters
  • Checking the Status of the Subsystem or a Measurement
  • Reading the Measurement Configuration
  • Modifying D-Series Applications for G-Series Systems
• 7 Balancing and Tuning a System
  • Balancing a System
  • Tuning a System
    • Learning About the System and Its Applications
    • Correcting Outstanding Problems
    • Measuring the System
    • Checking and Tuning Problem Areas
• A Creating an Enform Report From Measure Data
  • Calculating Values
    • Busy Values
    • Queue Lengths
    • Rates
  • Creating UserDefined Variables
  • Creating UserDefined Records
  • Creating an Enform Report
    • NEWSUBVL—Establishing the Subvolume
    • STARTENF—Creating the Report
• B Examples of RECORD Statements and FIND Queries
• C Loading Measure Data Into an SQL Table
• D Example of Measurement Application inC
• E Converting Existing Applications or Enform Reports to ZMS Style Record Formats
  • Using New Counter Fields
  • Using Existing Counter Fields
  • Application Conversion Considerations
• Index