EXPLAINing SQL Code, Append | Candle-lite DB2 instruction

		Using the Callable Interface

Field		Description

Type of Save	Type of save to be executed when saving SQL text to the member
	specified within the SQL statement PDS. Values are REPLACE and
	APPEND.
	■	REPLACE writes over an existing member or creates the member if it
	■
		does not currently exist. System default.
	■	APPEND concatenates the new SQL text to the existing number.

Default Qualifier	Qualifier to use to qualify unqualified tables, views, and aliases in SQL
	statements.

Qualifier Option	Type of qualifier. Values are USE and PROMPT.
	■	USE indicates the current Default Qualifier for unqualified SQL text.
	■
	■	PROMPT indicates you want to be prompted for a Qualifier
		whenever an SQL statement is used.

Gather Statistics	■	Type YES to have !DB/EXPLAIN gather statistics.
	■	Type NO to bypass.

Initial Report	Type the name of the initial !DB/EXPLAIN report to be displayed:
	ESTMT, EPATH, EPTBL, EOBJ, or ERECM.
	■	ESTMT is the actual SQL statement text being explained. If there is
		an SQL error, SQL error text also appears. Use the pushbuttons to
		select from the other !DB/EXPLAIN report sections that follow.
	■	EPATH is a narrative describing the access path for the SQL
		statement.
	■	EPTBL reports the plan table entries for the SQL statement in
	■
		tabular form.
	■	EOBJ reports the DB2 catalog statistics for objects referenced by the
		SQL statement. This section is available if you specified Yes for
		Gather Statistics in the D2/EXPLAIN Options panel under the
		Option pull-down (fastpath 08).
	■	ERECM provides suggestions for optimizing the SQL statement.
	For more information about !DB/EXPLAIN parameters, see the
	!DB/EXPLAIN Reference Manual.

EXPLAINing SQL Code

Use the following procedure to EXPLAIN SQL.

Step	Action

1	Log onto CUA.

Customizing OMEGAMON II

61

Image 61

Candle-lite DB2 manual EXPLAINing SQL Code, Use the following procedure to Explain SQL, Append

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 About This Book Where to look for informationWho should read this book Documentation set information Adobe Portable Document Format Printing problems?Introduction Documentation Conventions REPORT=SUMMARY Histogram Candle Customer Service and Satisfaction contacts Candle Customer Service and SatisfactionBackground Page Omegamon II for DB2 User’s Guide CUA Interface, Version New IFCID-based reports Historical Reporter redesign Long name support Bit addressing supportUnicode support Enclave support Distributed Thread display improvements New Dsnzparm fields Omegamon II for DB2 User’s Guide CUA Interface, Version Introduction Chapter Contents Signing On Where applid is the application nameLogging on to the application Sign On panel Sign On panel fields Accessing Omegamon from OmegaviewFields of the Sign On Panel are defined in the table below Field Description Logon Options panel fields Setting Logon Options Logical rows Number of logical rows Returning to Omegaview from Omegamon Signing Off Panel features Panel FeaturesPart Feature Description Part Feature Description Description Data PanelsHighlighted data fields Scrolling Pushbuttons Selecting from the action bar Action BarFast pathing from the action bar Actions pull-down View pull-down GoTo pull-down Tools pull-down Options pull-downHelp pull-down Action Codes Using an action codeAvailable action codes You can use these action codes in Omegamon Function Keys Default function key assignments are listed belowFunction key assignments Function Name Assignment Key PA1 CUA/TSOOmegaview PA2 Omegaview Help from a panel Getting HelpHelp from the action bar Help menu provides the following selections Searching the glossary Using the GlossaryIf you are Help function keys Customizing Omegamon Introduction Using the Preferences window Accessing the Preferences windowTo access the Preferences pop-up window Specifying Panel Preferences Action to occur Using the Terminal Options window Accessing the Terminal Options windowSpecifying Terminal Options Manual Values for SQL Description Process LevelAuto Save Saving for current session Saving Terminal OptionsSaving to a profile Accessing the Thresholds window Setting ThresholdsUsing the thresholds windows Follow these steps to change threshold values Saving threshold values Assigning User Authorities Accessing user authoritiesAdding a user Deleting a user Maintaining Profiles Accessing profile maintenanceProfile types Omegamon II uses three different profiles Copying a profile D61A$DEFAULT Exporting a Profile Importing a ProfileDeleting a profile Modifying a profile description Using the Dynamic Profile Update Facility Switching profiles Example command for importing a profile Example command for exporting a profileMVS Modify command for exporting a profile is as follows MVS Modify command for importing a profile is as follows Accessing the Filter Options window Setting Filtering Options for Near-Term Thread HistoryUsing the Filter Options window To access the Filter Options pop-up window Time Using the Save SQL Text Parameters window Accessing the Save SQL Text Parameters windowSpecifying Save Options for SQL Text Set up the CUA options Set up the !DB/EXPLAIN options Using the Callable Interface Setting Up the CUA Options Setting Up !DB/EXPLAINSQLID.PLANTABLE Step Action Log onto CUA Use the following procedure to set up the D2/EXPLAIN options Setting Up the D2/EXPLAIN Options Text and invokes the Explain function EXPLAINing SQL Code Use the following procedure to Explain SQLAppend CPU % Press the Process SQL key Page This chapter describes how to use Omegamon Using Omegamon DB2 subsystem components Monitoring from the System Status PanelMonitored objects Alert notification Status indicatorsInvestigating an alert Color Status Performing actions from the System Status panel Cics exceptions System Status Components and Related ExceptionsDescription Code Explanation TSO exceptions IMS exceptionsBackground exceptions Utility exceptions Following exceptions apply to active threads Active thread exceptions Buffer pool exceptions Inactive thread exceptionsFollowing exceptions apply to buffer pool resources Lock statistics exceptions EDM pool exceptionsLog manager exceptions DDF statistics exceptions Lock exceptions DB2 activity exceptionsFollowing exceptions apply to DB2 activity alerts Following exceptions apply to lock alerts Stored procedures exceptions Volume activity exceptionsActive trace exceptions User-defined functions exceptions Triggers exceptionsFollowing exceptions apply to alerts relating to triggers Following exceptions apply to user-defined functions Active threads alert Investigating an Active Threads AlertException recommendations Investigating the exception condition Displaying all exceptions Evaluating and Modifying ThresholdsModifying thresholds Adding or modifying rules Reviewing Near-Term History Data Accessing near-term history dataThread activity for a reporting period Thread activity for a report interval Specifying background application trace options Initiating a background application trace Identifying the dataset to which trace data is written Size Size of the dataset in megabytes VolumeViewing the list of background traces Name of the dataset you want to create Activities you can perform in a background trace request Overview Using the Ifcid Trace FacilityStarting an Ifcid Trace 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 When to use the complementary functions Using Omegamon II and !DB/EXPLAIN Complementary FunctionsAssumptions 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 What functions can you use? Moving Interactively between !DB/EXPLAIN and OmegamonModes of operation Procedure to use the full function of !DB/EXPLAIN Prerequisites for real time accessWhat happens when you cancel the Omegamon II session? Prerequisites to using the copy-and-paste facility Using the Copy-and-Paste Facility in OmegamonCapturing SQL from a running thread Capturing SQL using the ATF Direction of access Accessing Omegamon II Trace Information from !DB/EXPLAINPrerequisites for using the Omegamon II trace information Procedure to obtain current trace information Task You Want to Perform Source of Information Sources of informationPage Appendix Contents Panel Navigation Flowcharts System Status panel Flowchart ConventionsElement Description DB2 System Status Workloads Panels IMS CicsTSO 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