Candle-lite DB2 manual

Using the OMEGAMON II for DB2 Callable Interface

Setting Up !DB/EXPLAIN

Use the following procedure to set up !DB/EXPLAIN for OMEGAMON II for DB2.

Step		Action

1	Ensure that !DB/EXPLAIN V510 PSP is installed on every DB2 subsystem where you
	want to EXPLAIN statements. For information on installing !DB/EXPLAIN, see the
	!DB/Tools for DB2 Installation and Customization Guide, Version 510.

2	Define Destination Plan_Tables. The Destination PLAN_TABLE will be the current
	SQLID.PLAN_TABLE.
	■	If the current SQLID.PLAN_TABLE does not exist, !DB/EXPLAIN attempts to
		create the tablespace PLANTBLS in the !DB/TOOLS default database.
	■	If the PLAN_TABLE cannot be created there, !DB/EXPLAIN attempts to create
	■
		the PLAN_TABLE in the database DSNDB04.
	■	If it cannot create the table, !DB/EXPLAIN issues an error message indicating that
		the EXPLAIN could not be performed.
	The current SQLID is determined by:
	■	whether EXP_POWERX is defined in the !DB/Tools profile dataset concatenation
		as a non-blank value (for example, EXP_POWERX=SAMHILL), if so, the current
		SQLID is the value specified for EXP_POWERX,
		or
	■	the current SQLID is determined by the DB2 security exit.

Setting Up the CUA Options

Use the following procedure to set up CUA options and to use the new !DB/EXPLAIN feature.

Step

Action

1Log onto CUA.

2From the main CUA panel (KD2001), select Options from the task bar and press Enter. The following pop-up appears.

1.Preferences...

2.Controls...

3.Set thresholds...

4.User authorities...

5.User Profiles...

6.Subsystem Profiles...

7.Near-term Thread History Filter...

8.D2/Explain Options...

F1=Help F12=Cancel

Using OMEGAMON II for DB2 with !DB/EXPLAIN

95

Image 95

Candle-lite manual Current Sqlid is determined by the DB2 security exit

Contents

User’s Guide CUA Interface Omegamon II for DB2 User’s Guide CUA Interface, Version Contents Index 129 List of Figures Omegamon II for DB2 User’s Guide CUA Interface, Version Preface Documentation set information Where to look for informationAbout This Book Who should read this book Introduction Printing problems?Adobe Portable Document Format Documentation Conventions REPORT=SUMMARY Histogram Background Candle Customer Service and SatisfactionCandle Customer Service and Satisfaction contacts Page Omegamon II for DB2 User’s Guide CUA Interface, Version New IFCID-based reports Historical Reporter redesign Enclave support Bit addressing supportLong name support Unicode support Distributed Thread display improvements New Dsnzparm fields Omegamon II for DB2 User’s Guide CUA Interface, Version Introduction Chapter Contents Sign On panel Where applid is the application nameSigning On Logging on to the application Field Description Accessing Omegamon from OmegaviewSign On panel fields Fields of the Sign On Panel are defined in the table below Logon Options panel fields Setting Logon Options Logical rows Number of logical rows Returning to Omegaview from Omegamon Signing Off Part Feature Description Panel FeaturesPanel features Part Feature Description Scrolling Data PanelsDescription Highlighted data fields Pushbuttons Fast pathing from the action bar Action BarSelecting from the action bar Actions pull-down View pull-down GoTo pull-down Help pull-down Options pull-downTools pull-down You can use these action codes in Omegamon Using an action codeAction Codes Available action codes Function Name Assignment Key Default function key assignments are listed belowFunction Keys Function key assignments PA2 Omegaview CUA/TSOPA1 Omegaview Help menu provides the following selections Getting HelpHelp from a panel Help from the action bar If you are Using the GlossarySearching the glossary Help function keys Customizing Omegamon Introduction Specifying Panel Preferences Accessing the Preferences windowUsing the Preferences window To access the Preferences pop-up window Action to occur Specifying Terminal Options Accessing the Terminal Options windowUsing the Terminal Options window Save Values for SQL Description Process LevelManual Auto Saving to a profile Saving Terminal OptionsSaving for current session Follow these steps to change threshold values Setting ThresholdsAccessing the Thresholds window Using the thresholds windows Saving threshold values Deleting a user Accessing user authoritiesAssigning User Authorities Adding a user Omegamon II uses three different profiles Accessing profile maintenanceMaintaining Profiles Profile types Copying a profile D61A$DEFAULT Modifying a profile description Importing a ProfileExporting a Profile Deleting a profile Using the Dynamic Profile Update Facility Switching profiles MVS Modify command for importing a profile is as follows Example command for exporting a profileExample command for importing a profile MVS Modify command for exporting a profile is as follows To access the Filter Options pop-up window Setting Filtering Options for Near-Term Thread HistoryAccessing the Filter Options window Using the Filter Options window Time Specifying Save Options for SQL Text Accessing the Save SQL Text Parameters windowUsing the Save SQL Text Parameters window Set up the CUA options Set up the !DB/EXPLAIN options Using the Callable Interface Step Action Log onto CUA Setting Up !DB/EXPLAINSetting Up the CUA Options SQLID.PLANTABLE Use the following procedure to set up the D2/EXPLAIN options Setting Up the D2/EXPLAIN Options Text and invokes the Explain function Append Use the following procedure to Explain SQLEXPLAINing SQL Code CPU % Press the Process SQL key Page This chapter describes how to use Omegamon Using Omegamon Monitored objects Monitoring from the System Status PanelDB2 subsystem components Color Status Status indicatorsAlert notification Investigating an alert Performing actions from the System Status panel Description Code Explanation System Status Components and Related ExceptionsCics exceptions Utility exceptions IMS exceptionsTSO exceptions Background exceptions Following exceptions apply to active threads Active thread exceptions Following exceptions apply to buffer pool resources Inactive thread exceptionsBuffer pool exceptions DDF statistics exceptions EDM pool exceptionsLock statistics exceptions Log manager exceptions Following exceptions apply to lock alerts DB2 activity exceptionsLock exceptions Following exceptions apply to DB2 activity alerts Active trace exceptions Volume activity exceptionsStored procedures exceptions Following exceptions apply to user-defined functions Triggers exceptionsUser-defined functions exceptions Following exceptions apply to alerts relating to triggers Investigating the exception condition Investigating an Active Threads AlertActive threads alert Exception recommendations Modifying thresholds Evaluating and Modifying ThresholdsDisplaying all exceptions Adding or modifying rules Thread activity for a reporting period Accessing near-term history dataReviewing Near-Term History Data Thread activity for a report interval Specifying background application trace options Initiating a background application trace Name of the dataset you want to create Size Size of the dataset in megabytes VolumeIdentifying the dataset to which trace data is written Viewing the list of background traces Activities you can perform in a background trace request Starting an Ifcid Trace Using the Ifcid Trace FacilityOverview Displaying Ifcid Trace Data Stopping an Ifcid Trace Page Using Omegamon II for DB2 Functions provided by !DB/EXPLAIN for DB2 Background about !DB/EXPLAIN for DB2 Assumptions Using Omegamon II and !DB/EXPLAIN Complementary FunctionsWhen to use the complementary functions Using Omegamon II and !DB/EXPLAIN Complementary Functions Using the Omegamon II for DB2 Callable Interface Testc Current Sqlid is determined by the DB2 security exit Fields for Terminal Description Options SQL Text ATF. You can access the SQL Text panel through Required fields for the SAVE/EXPLAIN option SAVE/EXPLAIN PDS Using the D2/EXPLAIN Options Panel From the other !DB/EXPLAIN report sections that follow Press the Process SQL key Modes of operation Moving Interactively between !DB/EXPLAIN and OmegamonWhat functions can you use? What happens when you cancel the Omegamon II session? Prerequisites for real time accessProcedure to use the full function of !DB/EXPLAIN Capturing SQL from a running thread Using the Copy-and-Paste Facility in OmegamonPrerequisites to using the copy-and-paste facility Capturing SQL using the ATF Procedure to obtain current trace information Accessing Omegamon II Trace Information from !DB/EXPLAINDirection of access Prerequisites for using the Omegamon II trace information Task You Want to Perform Source of Information Sources of informationPage Appendix Contents Panel Navigation Flowcharts Element Description Flowchart ConventionsSystem Status panel DB2 System Status Workloads Panels TSO CicsIMS Cics IMS TSO Workloads Panels Near-term history Resources Panels Resources Panels Realtime Resources Panels Near-Term History Alerts Panels Alerts Panels Installation Parameters Panels Installation Parameters Panels Application Trace Facility Panels Application Trace Facility Panels Object Analysis Panels Object Analysis Panels Thread Detail GoTo Panels Thread Detail GoTo Panels Realtime Thread History Detail GoTo Panels Near-Term History Index Omegamon II for DB2 User’s Guide CUA Interface, Version 131 Omegamon II for DB2 User’s Guide CUA Interface, Version