Using IBM Application Development Tools for z/OS and OS/390

Using IBM Application Development Tools for z/OS and OS/390

by Joe DeCarlo, Peter Henningsen, Paula Hesketh, Lars-Erik Olsson
Released May 2004
Publisher(s): IBM Redbooks
ISBN: None

Read it now on the O’Reilly learning platform with a 10-day free trial.

O’Reilly members get unlimited access to books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.

Start your free trial

Book description

This IBM Redbooks publication introduces the IBM Application Development Tools for z/OS and OS/390. The first chapter provides a high level overview of each of the products, suitable for any person that requires an introduction to these capabilities.

The remainder of the book delivers more technical information, including numerous examples of some of the most commonly used functions of each tool and scenarios of how the tools could be used in an everyday customer environment.

The specific application development tools for z/OS and OS/390 covered in this book are:
IBM File Manager for z/OS and OS/390, Version 4, Release 1
IBM Fault Analyzer for z/OS and OS/390, Version 4, Release 1
IBM Application Monitor for z/OS and OS/390, Version 2, Release 1
IBM Workload Simulator for z/OS and OS/390, Version 1, Release 1
IBM Debug Tool for z/OS and OS/390, Version 4, Release 1

Please note that the additional material referenced in the text is not available from IBM.

Table of contents

  1. Notices
    1. Trademarks
  2. Preface
    1. The team that wrote this redbook
    2. Become a published author
    3. Comments welcome
  3. Chapter 1: Application development tools for z/OS and OS/390
    1. Background
    2. Products used during the development of this redbook
    3. Getting started
    4. File Manager
      1. Overview
      2. Major functions
    5. IBM Fault Analyzer
      1. Overview
      2. Major functions
    6. IBM Debug Tool and Utilities
      1. Overview
      2. Major functions
    7. Application Monitor
      1. Overview
      2. Major functions
    8. Workload Simulator
      1. Overview
      2. Major functions
    9. Summary
  4. Chapter 2: Introducing File Manager
    1. What can File Manager be used for?
      1. Performance guidelines
      2. Conventions used
      3. A simple copy
      4. Selective copying
      5. How to perform a global find and replace in a PDS (1/2)
      6. How to perform a global find and replace in a PDS (2/2)
      7. How to create one VSAM file using another as a model
      8. How to initialize a VSAM file with low-value records
      9. How to populate this newly created file
      10. How to split a single file into constituent record types
      11. Replace a string in a specific location in a file
      12. Copy selected variably blocked records to another file
      13. Search for a string in all members of a PDS
      14. Multiple Find
      15. QSAM allocation using a model
      16. Work with VTOC
      17. Get information about a load module
      18. Dynamic template
      19. Compare data sets using templates
      20. Working with DB2 (1/3)
      21. Working with DB2 (2/3)
      22. Working with DB2 (3/3)
      23. Working with IMS (1/3)
      24. Working with IMS (2/3)
      25. Working with IMS (3/3)
    2. Template processing
      1. It really does remember the copybook
      2. Using the SELECT command in template edit
      3. How to process COPY REPLACING statements
      4. How to build a template for multi-record file layouts
    3. Hints and tips
      1. System programmer notes
      2. Look out for your PF keys
      3. What to do when a copybook fails to compile
      4. Record structure defined in source application program
      5. Watch out for that bad disposition
    4. Copybook and include
  5. Chapter 3: Introduction to Fault Analyzer
    1. Start by validating your software levels
      1. Fault Analyzer software level
    2. How Fault Analyzer works
    3. Preparing your programs for Fault Analyzer
      1. Compiler options
    4. Introduction to Fault Analyzer main screen
      1. Content of Fault Entry List panel
      2. Customization of Fault Entry List panel
    5. Using FA to analyze an abend
      1. Interactive reanalysis
      2. Synopsis section
      3. Point of failure section (1/2)
      4. Point of failure section (2/2)
      5. Events section
      6. System-wide information section
      7. Abend job information
      8. Options in effect section
      9. Batch reanalysis
      10. Real-time report
      11. The fast-path for solving this dump (1/2)
      12. The fast-path for solving this dump (2/2)
      13. DB2 related information
      14. CICS related information
      15. IMS related information
    6. Some very useful functions
      1. Adding user title to a fault entry
      2. Creating user notes in a dump
      3. DSECT mapping
    7. Customizing Fault Analyzer
      1. User options file
      2. Notification when program abends
      3. Placing abends in different history files
    8. Analyzing a CICS system dump
  6. Part 1: Application Monitor
    1. Chapter 4: Introduction to Workload Simulator
      1. Overview
        1. General process
        2. WSim installation
        3. Resources WSim can simulate
        4. Testing with WSim
      2. System configuration
        1. Physical configurations
        2. Logical configurations
      3. Script preparation (1/2)
      4. Script preparation (2/2)
        1. Network definition statements
        2. Message generation decks
        3. Options for creating message generation decks
        4. Testing scripts
      5. WSim output
      6. Operating WSim
        1. Initializing, starting, and stopping a network
        2. Changing and resetting network parameters
      7. WSim Test Manager (1/8)
      8. WSim Test Manager (2/8)
      9. WSim Test Manager (3/8)
      10. WSim Test Manager (4/8)
      11. WSim Test Manager (5/8)
      12. WSim Test Manager (6/8)
      13. WSim Test Manager (7/8)
      14. WSim Test Manager (8/8)
        1. WTM operating modes
        2. WTM utilities
        3. Testcases
        4. Testgroups and testcycles
        5. Schedules
        6. Output reports
        7. Model scripts
    2. Chapter 5: Using Application Monitor
      1. Why does an application developer need a profiler?
        1. During application development
        2. During application test
        3. During application service
        4. During application maintenance
        5. Other uses
      2. Some things to remember when using Application Monitor
      3. Basic functionality
        1. Analyzing an active job
        2. Analyzing a specified job
        3. Scheduling a deferred monitoring request
        4. Analyzing historical data
        5. Named sets: what they are and why they can help
      4. Some available reports
        1. Program reports
        2. Delay Analysis reports
        3. Data Set Analysis reports
        4. CICS reports
        5. DB2 reports
        6. IMS reports
      5. Things to remember when using Application Monitor
    3. Chapter 6: Setting Defaults for Application Monitor
      1. Setting default values
      2. Default sampling parameters panel
      3. Default data set names panel
    4. Chapter 7: A Quick Application Monitor Tour: Active and post analysis
      1. Using Application Monitor to monitor a running task
      2. Analyzing an active job (1/2)
      3. Analyzing an active job (2/2)
      4. Analyzing historical data (1/3)
      5. Analyzing historical data (2/3)
      6. Analyzing historical data (3/3)
        1. Specifying how you want to analyze the historical data
        2. Analyzing historical data as one large segment
        3. Analyzing historical data as multiple intervals
        4. Analyzing a subset of the historical data
    5. Chapter 8: Application Monitor and COBOL
      1. Overview
      2. Setting up the defaults for the analysis run
      3. Analyzing the job
      4. Available reports
      5. Program reports
        1. Instruction Analysis report
        2. Statement Analysis report
      6. Delay Analysis reports
      7. Data Set Analysis reports
    6. Chapter 9: Application Monitor and PL/I
      1. Overview
      2. Setting the defaults
      3. Analyze a specified job
      4. Program reports
      5. Delay Analysis reports
      6. Data Set Analysis report
    7. Chapter 10: Application Monitor and CICS
      1. Overview
      2. Setup
      3. Analyzing a CICS region and transaction
        1. Available reports
        2. Data Set Analysis report
        3. Delay Analysis report
        4. CICS specific reports
        5. Program reports
      4. History files and historical data analysis
    8. Chapter 11: Application Monitor: Generating reports in batch
      1. Overview
      2. The JCL - SFBIJCL(FBIBATCH)
  7. Part 2: Debug Tool
    1. Chapter 12: Introducing the Debug Tool debugger interfaces
      1. Batch mode user interface
      2. Main frame interface
        1. Review of screen areas
      3. WebSphere Studio Enterprise Developer
      4. IBM Distributed Debugger/VisualAge Remote Debugger
      5. Matching interfaces to supported environments
    2. Chapter 13: Specifying the TEST runtime option in Debug Tool
      1. Anatomy of the TEST runtime option
        1. Specifying file names in the TEST runtime option
        2. Recommended allocations for command and preference files
        3. Sample runtime options
      2. Specifying the TEST runtime option
        1. Defining runtime options using CEEUOPT
        2. Specifying the TEST runtime option on the command line
        3. Specifying the TEST runtime option on JCL
    3. Chapter 14: Some useful Debug Tool commands
      1. Descriptions of frequently used commands
      2. Descriptions of some interesting commands
      3. Finishing a Debug Tool session
    4. Chapter 15: Debug Tool and debugging PL/I
      1. Preparing a PL/I program for debugging
        1. Notes on preparing a PL/I V2R3 program for Debug Tool
        2. Notes on all other PL/I compilers
      2. A quick run through the program
      3. A quick test using the MFI debugger (1/3)
      4. A quick test using the MFI debugger (2/3)
      5. A quick test using the MFI debugger (3/3)
      6. A debug session with the remote debugger (1/3)
      7. A debug session with the remote debugger (2/3)
      8. A debug session with the remote debugger (3/3)
    5. Chapter 16: Debug Tool and debugging COBOL
      1. Preparing IBM Enterprise COBOL for z/OS and OS/390 using Debug Tool Utilities
      2. Manage and use Debug Tool setup files (1/2)
      3. Manage and use Debug Tool setup files (2/2)
    6. Chapter 17: Debug Tool and debugging C/C++
      1. Preparing a C or C++ program for debugging
      2. Using the MFI debugger (1/2)
      3. Using the MFI debugger (2/2)
      4. Using the remote debugger (1/3)
      5. Using the remote debugger (2/3)
      6. Using the remote debugger (3/3)
      7. Using the ctest() function to start the debugger (1/2)
      8. Using the ctest() function to start the debugger (2/2)
        1. Using the ctest() function
        2. Specifying runopts when using ctest()
        3. Example
    7. Chapter 18: Using Debug Tool under UNIX System Services
      1. Common considerations for all languages
        1. Specifying the TEST runtime option
        2. Special considerations for running DLL applications from the shell
      2. Using C/C++ and Debug Tool under USS
        1. Compiling a C/C++ application
        2. Debugging a USS application
    8. Chapter 19: Using Debug Tool with IMS
      1. Traditional methods of debugging under IMS
      2. Debugging with IMS V8 and above
        1. Linking an application to allow the managing of runtime options
        2. A tour of the new DTU IMS facilities
        3. Precedence of the information on the LE Runtime Options panel
    9. Chapter 20: Using Debug Tool with CICS
      1. CICS application program considerations
      2. Invoking Debug Tool
    10. Chapter 21: Using Debug Tool with DB2
      1. Compiling for DB2 and Debug Tool
      2. Invoking a DB2 application using the TEST runtime option
      3. Using DTSU to invoke your DB2 application
      4. DB2 stored procedures considerations
    11. Chapter 22: Using Debug Tool Coverage Utility
      1. Start by validating your software levels
      2. Overview
        1. DTCU requirements
        2. Running DTCU consists of the following steps
      3. Using DTCU (1/2)
      4. Using DTCU (2/2)
        1. Starting the DTCU ISPF dialog
        2. Modifying your DTCU defaults
        3. Compiling the program to be measured
        4. Setting up your control file
        5. Create the setup JCL
        6. Create JCL to start a monitor session
        7. Create JCL for a report
        8. Jobs generated so far
        9. Perform the setup step
        10. Perform the link step
        11. Start the monitor session
        12. Start your program
        13. Display statistics online
        14. Stop the monitor
        15. Create the summary report
        16. Create the summary report and annotated listing report
        17. Use of the monitor panel
        18. Fast Path
      5. Restrictions
        1. CICS
        2. Other environments
        3. UNIX System Services
      6. Installation
        1. Systems programmer notes
    12. Chapter 23: Compiling and converting old COBOL code with Debug Tool Utilities
      1. Overview
        1. What do the conversion tools need
      2. Setting up for convert and compile
        1. Ensure that the Compiler and Converter Settings are correct
      3. Start the conversion process
      4. Convert old 68/74 COBOL to 85 COBOL
      5. Summary
  8. Part 3: Scenarios
    1. Chapter 24: Introduction to the scenarios
      1. Scenarios: Overview
        1. Overview of the programs
        2. S/390 software prerequisites
      2. Install the application software
        1. Install the demo files
        2. Copy the demo files to your user ID
        3. Set up the applications
      3. About the system configuration
        1. About the S/390 software prerequisites
        2. About the CICS configuration
        3. About the DB2 configuration
      4. Validate the installation
    2. Chapter 25: Guided tour of the Trader application
      1. Getting started
      2. Trader application in CICS
        1. Log on to the application
        2. Running the Trader application
        3. Obtain real-time quotes
        4. Buy shares
        5. Sell shares
      3. Running the Trader application in batch
        1. Run the batch job
        2. Check the result
    3. Chapter 26: Scenario 1: Invalid VSAM data generating an abend
      1. Set up the components
        1. CICS components
        2. Program products
      2. Tracking an abend in the application (1/3)
      3. Tracking an abend in the application (2/3)
      4. Tracking an abend in the application (3/3)
        1. Viewing the abend in Fault Analyzer
        2. Using Debug Tool to analyze the problem
        3. Using File Manager to correct a problem with data
        4. Running the application after the fix
      5. Summary of Scenario 1
    4. Chapter 27: Scenario 2: Using Debug Tool
      1. Set up the components
        1. Batch components
        2. Program products
      2. Walkthrough of the batch Trader application
        1. The Trader batch job
        2. The transaction file
        3. Listing shares
        4. Buying shares
        5. Selling shares
      3. Tracking a problem with the application (1/3)
      4. Tracking a problem with the application (2/3)
      5. Tracking a problem with the application (3/3)
        1. Using Debug Tool in batch mode to try to find the error
        2. Using Debug Tool in DTSU to pin-point the solution
        3. Executing the batch application after the fix
      6. Summary of scenario 2
    5. Chapter 28: Scenario 3: Is the error in DB2 data or program logic?
      1. Set up the components
        1. CICS and DB2 components
        2. Program products
      2. Tracking a problem in the application (1/3)
      3. Tracking a problem in the application (2/3)
      4. Tracking a problem in the application (3/3)
        1. Recreating the error
        2. Viewing the data in File Manager/DB2
        3. Using Debug Tool to identify the logic problem
        4. Using File Manager/DB2 to correct the data
      5. Summary of Scenario 3
    6. Chapter 29: Scenario 4: Workload Simulator
      1. Set up the components
      2. Creating the simulation test items
      3. Running the simulation
      4. Simulation output
      5. Report for TDB2 transaction
  9. Part 4: Appendixes
    1. Appendix A: Supporting information
      1. Fault Analyzer notification user exit
      2. File Manager ISPF panel modifications
      3. File Manager batch job to process multi-record file
      4. Language Environment runtime options report
      5. Convert multiple sequential files to members of a PDS
      6. Components of the Trader application
    2. Appendix B: Database generation samples
      1. File Manager DB2 IVP databases installation (1/2)
      2. File Manager DB2 IVP databases installation (2/2)
      3. File Manager IMS IVP databases installation (1/2)
      4. File Manager IMS IVP databases installation (2/2)
    3. Appendix C: Additional material
      1. Locating the Web material
      2. Using the Web material
      3. System requirements for downloading the Web material
      4. How to use the Web material
  10. Related publications
    1. IBM Redbooks
      1. Other resources
    2. Referenced Web sites
    3. How to get IBM Redbooks
      1. IBM Redbooks collections
  11. Index (1/4)
  12. Index (2/4)
  13. Index (3/4)
  14. Index (4/4)
  15. Back cover

Product information

  • Title: Using IBM Application Development Tools for z/OS and OS/390
  • Author(s): Joe DeCarlo, Peter Henningsen, Paula Hesketh, Lars-Erik Olsson
  • Release date: May 2004
  • Publisher(s): IBM Redbooks
  • ISBN: None